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1   Overview  and  Introduction 

One  of  the  uses  for  a  network  such*  as  the  Arpanet  or  Plat- 
form network  is  allowing  the  user  to  access  any  host  computer  on 
the  network  for  t  i  ne  shar  i  no .  work  on  the  loc^l  system  need  not 
involve  the  net -or k  at  all/  but  to  net  across  the  network  to  a 
foreign  computer  system  one  needs  a  way  to  permit  network  access. 
for  the  local  timesharing  user  a  program  to  allow  access  to  the 
net  is  sufficient;  for  the  foreign  system/  a  program  to  allow  the 
remote  user  access  to  the  facilities  is  required,. 

The  entire  scheme  for  cross-net  timesharing  use  is  called 
Telnet-  Telnet  is  divided  into  the  two  parts  described  above: 
User  telnet/  allowing  the  local  user  tc  access  other  portions  of 
the  network;  Server  telnet/  which  permits  a  user  access  to  a 
machine  which  is  not  local  to  him/her.  The  two  telnets  (User  in 
the  user's  local  machine  end  Server  in  the  remote  machine  the 
user  wishes  to  use)  provide  a  framework  to  allow  easy  access  to 
machines  across  the  net.  Within  this  framework  are  provisions  to 
transmit  special  function  commands  to  telnet  for  more  precise 
control  of  the  connection  and  remote  process(es). 

1.1   The  Network  Virtual  Terminal 
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1.2   General  operation  of  Telnet 


The  user  telnet  program  may  be  logically  divided  into 
several  sections  to  perform  various  functions.  The  major  func- 
tions are:  Get  characters  from  the  terminal  and  transmit  them  to 
the  network;  inter fret  certain  of  these  characters  (or  strinos  of 
them)  as  commands  to  user  telnet;  receives  characters  from  the 
network  and  transmit  them  to  the  user's  terminal.  Since  the  pur- 
pose of  telnet  is  shuffling  characters  back  and  forth/  it  must  be 
made  as  convenient  as  possible  to  do  so.  Toward  this  end, 
several  different  terminal  modes  aro  provided  which  dictate  cer- 
tain of  the  parameters  for  handling  characters.  Further/  a 
shortcut  method  (character  mapping)  is  provided/  along  with 
methods   tor   directing   the  control  of  the  state  of  user  telnet/ 
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and  the  network  connection  in  general.  Naturally/'  with  all  these 
functions/'  w e  will  absolutely  need  at  least  one  more  -  help  capa- 
bilities may  be  invoked  for  any  of  the  telnet  command  keywords. 


This  document  describes  Unix  Telnet.  Since  the  telnet  user 
needs  not  interact  with  server  telnet/'  little  if  any  information 
on  it  appears  in  the  user's  quide  (but  it  is  dealt  with  in  the 
ma  i  r.t  e-nence  section).  Program  operation  and  function  are  dis- 
cussed in  sever j I  sections/  which  get  progressively  more  de- 
tailed. 
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2   User  Telnet  User's  Guide 

This  section  of  the  document  reler-3  to  necessary  information 
for  operating  user  telnet.  Included  are  instructions  for  running 
user  telnet/  descriptions  and  effects  of  the  various  commando 
user  telnet  provides/  and  some  of  the  conceptual  highlights  of 
telnet.  Much  of  the  description  of  telnet's  capabilities  is 
found  in  the  command  descriptions/  with  further  explanation  in 
the  elaboration  section  -  all  telnet  users  dre  urged  to  read 
these  sections  carefully/  and  refer  to  them  for  additional  infor- 
mation after  using  telnet  for  a  while  and  'getting  a  feel'  for 
the  program. 

2.1   Simple  use  of  User  Telnet 

Actually/  user  telnet  is  quite  easy  to  use.  It  has  been 
said  that  for  most  reasonable  hosts  one  need  neve  r  use  telnet 
commands  other  than  those  for  establishing  ano  closing  a  connec- 
tion. The  relatively  large  number  of  commands  need  not  frighten 
the  novice  or  undemanding  user;  thc-y  dre  provided  for  the  experi- 
enced user  who  wishes  telnet  to  do  clever  manipulations. 

2.1.1   Invoking  User  Telnet 

Running  user  telnet  is  quite  easy/  all  one  needs  to  type  is: 

telnet 

whereupon*  telnet  will  respond  with  a  herald  message  and  give  you 
a  prompt  (currently  * " *  L 1 3  by  default).  The  appearance  of  the 
prompt  indicates  that  telnet  is  ready  to  accept  a  command. 

Of  course/  if  you  don't  know  what  to  do  at  a  command  prompt 
(or  don't  need  to  use  any  commands)/  you  can  circumvent  seeing 
one  by  typing: 

telnet  <hostname> 

where  <hostname>C?J  represents  the  name  of  a  network  server  host. 


C1D  The 
printers/  *nd 


character    "'   appears 
an  up-arrow  on  others. 


a  s 


carat   on  some 


f?3  The  lexical  construction  * <word>*  is  used  to 
indicate  one  of  many  possible  parameters.  The  angle 
brackets  ("<"/  ">">  are  not  included.  The  item  enclosed  in 
the  brackets  is  mnemonic  for  the  parameter/  but  is  not  the 
paramete  r  itself. 
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Telnet  then  attempts  to  connect  you  to  the  specified  host.  For 
mnemonic  eisc-/  you  may  instead  type: 

con  <fiostnamc> 

(in  fact/  'con'  is  a  synonym  for  'telnet')  .  C33  'Con*  is  short 
for  "connect*.  l-or  example/  to  initiate  a  connection  to  a 
foreign  host  named  overtherc/  one  would  type: 

con  overt  here 

Of  course^  you  could  use  'telnet'  instead  of  'con'. 

2.1.2   Extra  Connection  Parameters 

For  those  who  want  a  bit  more  control  over  their   connection 
requests/  parameters  are  available/  thus: 


telnet  ChostnameD  C<paramet ers >J 


Or  ..  . 


con 


ChcstnameD  C<parameters>3 


The  optional [43  pa ra meters  to  telnet/  specified  above/  consist  of 

the   flag   character   '  -  *  /   a   switch   key-letter/  and  additional 

argument (s>  which  are  usually  integer(s).   Telnet  will  interpret 

any   integer   c  s   decimal/   unless   the  first  digit  is  a  " 0  *  -  in 

which  case  it  will  be  interpreted  as  octal.   Switches  and   their 
arguments  (with  integers  represented  as  *#*)  are: 


-a  n 


desired  message  allocation  size 


"6  ti  ft  specifies  a  direct  connect  (as  opposed  to  normal 
ipc)  fore inn  socket.  a  36  bit  quantity  which  is  speci- 
fied as  two  16  bit  integers/  high  order  portion  first, 
usually/  one  wants  the  s  switch/  not  this  one. 


-h  U 


host  number  of  the  desired  host  (use   without   the 


C  3  3  A  word  about  a  possible  confusion  is  in  order  here, 
both  'con'  and  'telnet'  will  get  you  into  telnet/  but 
neither  is  a  telnet  con-manci  -  they  are  noth  names  for  the 
user  telnet  (.roirara.  Later/  we  shall  see  that  there  are 
also  telnet  commands  by  these  naniet;  remember  that  they  are 
not  the  same  thing. 

CiJ  Throughout  this  document/  option.il  items  will  be 
enclosed  in  square  brackets  ("["/  "J").  Hopefully/  this 
will  not  cause  confusion  with  footnote  references. 
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liostn  jrnc) 

-d  0  tl  direct  connect  foreign  socket  (32  bit  number*  with 

the  high  order  half  first).. 


-s  n 
-t  tf 


foreign  socket  to  connect  to  ( default  is  1) 
number  of  seconds  before  timeout  (default  120) 


These  switches  are  all  optional  and  may  be  in  any  order;  however/' 
the  hostname  (if  present)  must  come  first.  Since  the  <hot>tname> 
and  *-h"  parameters  both  specify  the  foreign  host/  only  one 
should  be  used  for  any  -'iver;  connection.  If  you  forget  to  in- 
clude a  number/-  a  zero  value  will  be  assumed  and  could  lead  you 
to  unexpected  results.  Refer  to  the  connection  discussion  in 
section  2.3.1  for  more  detail. 

2.2   Telnet  Commands 

In  order  to  make  telnet  versatile/-  a  wealth  of  commands  is 
available.  The  intention  is  to  satisfy  the  demanding  user  as  well 
as  those  who  have  no  need  for  telnet's  full  power.  Telnet  dis- 
tinguishes a  command  line  (that  is*  a  line  it  is  to  interpret) 
from  normal  data  to  go  to  the  network  by  the  presence  of  a  spe- 
cial escape  character  as  the  first  character  on  the  line  (see  the 
escape  command).  Obviously*  if  there  is  no  network  connection 
open*  everything  you  type  must  be  intended  for  telnet's  interpre- 
tation* and    the  escape  character  is  optional. 

When  choosing  the  names  for  the  telnet  commands*  efforts 
were  made  to  keep  them  distinct  from  the  names  of  Unix  commands. 
This  consideration  permits  the  user  even  greater  flexibility  in 
using'  telnet  because  i1  telnet  does  not  recognize  the  command  en- 
tered* it  trys  to  execute  it  via  a  shell.  In  other  words*  if  you 
type  a  'string  to  telnet  that  it  does  not  know  about*  it  ass u -res 
that  command  to  be  a  Unix  command*  and  attempts  to  execute  it* 
complete  with  whatever  arguments  you've  typed. 

Many  telnet  commands  may  be  used  in  different  contexts. 
Some  commands  may  be  used  by  themselves*  some  are  prefixes  to 
other  commands*  some  may  be  optionally  prefixed*  arid  some  require 
a  prefix.  The  prefixing  rules  ;ire  designed  to  avoid  confusion 
for  the  novice  in  learning  telnet  commands*  and  to  prevent  ac- 
cidental errors.  Be cause  most  commands  may  be  used  with  or 
without  prefixes*  the  distinction  between  commands  and  their 
parameters  sometimes  becomes  blurred.  In  some  cases*  keywords 
will  be  spoken  ibout  -  these  are  the  character  strings  that  tel- 
net recognizes  which  have  signitigance*  be  they  commands*  pre- 
fixes* etc. 
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2.2.3   Command  Classes 

Telnet's  commands  can  he  divided  into  two  classes:  those  re- 
lated to  control  of  the  communication  path  to  a  foreign  host;  und 
those  *ihich  control  the  state  of  the  telnet  process  and  allow  the 
user  to  access  various  help  functions.  Commands  in  the  first  set 
deal  with  the  cpenino  of  connections  to  foreign  network  servers/ 
conversations  with  them/  and  the  termination  of  those  connec- 
tions. These  connect  ions  follow  the  telnet  protocol C5D  The 
second  conn  and  cl:iss  controls  loeel  functions  and  parameters  such 
as:  the  treatment  of  characters  obtained  from  the  standard  input 
file/  help  functions/  status  inquiries/  and  the  state  of  the  lo- 
cal terminal. 

In  th?  following  sections  the  commands  are  split  into  these 
two  functional  groups  and  alphabetized  within  each  croup  to  ease 
later  reference.  In  the  d.se  of  all  keywords/  the  full  string 
need  not  be  given  -  merely  enough  to  be  unique. 

2. 2. U       Lexical  Conventions 


Seversl  shorthand  notations  are  used  in  the  command 
tions/  especially  in  the  line  giving  the  valid  syntax 
command.   These  are : 

a)  Optional  items  are  enclosed  in  square  brackets  ("C"/ 

b)  Command  syntax  lines  list  the   entire   command   -   p 
parameters/  and  all. 

c)  Parameters  are  usually  specified  by   mnemonics   encl 
angle  brackets  ("<"/  ">") 

d)  Urn  mp  I  ement  ed  commands'  are  enclosed  in   double   curl 


descrip- 
f  o  r  each 

r  e  f  i  x  e  s  .• 
o  s  e  d  in 
y  -b  r  a  c  e  s 


2.2.5   Connection  related  commands 


CsendD 


30 


Causes  immediate  transmission  of   a   telnet   Abort 
Output  command  to  the  serving  host. 


CsendU 


ayt 


Causes  immediate  transmission  of  a  telnet  Are   You 
There  command  to  the  serving  host. 


C 5 D  At  this  time/  the  Platform  protocol  specifications 
are  extremely  similar  to  the  specifications  for  the  Arpa 
network  telnet  protocol/  which  may  be  found  in  the  Arpa 
Telnet  Protocol  Specification  (NIC  18639). 
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Csend]     brk 


Causes  immediate  transmission  of   a   telnet   t>  R  e  a  K 
com m and  to  the  serving  host. 


bye 


Synonym  for  end;  closes  a  connection/  if  open/  and 
exits  telnet. 


cl  ose 


Closes  any  open  connection  and  returns   to   telnet 
command  level. 


connect  [hostname}  C  <  p  a  r  a  m  e  t  e  r  s  >  D 

Attempts  to  open  the  requested  connection  to  a 
foreign  host.  This  command  is  a  synonym  for  the 
'telnet'  command. 


C  s  e  n  d  3     del 


disconnect 


send 


send 


end 


exit 


ec 


el 


Causes  immediate  transmission  of  an   ASCII   DELete 
character  (octal  0177)  to  the  serving  host. 


This  command  closes  the   current   net   connection; 
it's  a  synonym  for  close. 


Causes  immediate  transmission  of  a  t  e I n  a t  Erase 
Character  command  to  the  serving  host.  (To  avoid 
confusion  with  the  'echo'  command/  the  prefix  is 
r equi  red )  . 


Causes  immediate  transmission  of  a  telnet  Erase 
Line  command  to  the  serving  host.  (To  prevent 
confusion  with  the  *eline'  command/  the  prefix  is 
requi  red )  . 


Exits  from  telnet/  after  closing  any  open  connec- 
tion find  restoring  things  to  normal.  This  command 
is  a  synonym  for  the  *  b  y  e  '  command. 


Synonym  for  end;  closes  a  connection/  if  open/  and 
exits  t  e I  net  . 


C  s  e  n d  3     goo 


C  s  e  n  d  3     i  p 


Causes  immediate  transmission  of  a  telnet  GU-Ahead 
command  to  the  serving  host. 
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nop 


Causes  immediate  transmission  of  a   telnet   Inter- 
rupt Process  command  to  the  serving  host. 


Causes  immediate   transmission   of   a   telnet   No- 
OPeration  com m rind  to  the  serving  host. 


open     [hostname]  [<paramet er s>3 

Synonym  for  the  telnet  command;  see  below. 

{{         option     <opt><mode>  >> 

Prefix  for  the  telnet  options.  Tells  telnet  to 
neqotiate  with  the  remote  server  to  set  telnet  op- 
tion <opt>  to  the  specified  node  (either  'on'  or 
'off').  See  section  on  telnet  protocols  and  op- 
t  ions  . 


quit 


Synonym  for  end;  closes  connection  (if 
exits  telnet. 
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C  s  e  n  d  3 


te Inet 


sync  h 


Causes  immediate  t r ansmi s s i on. of 
sequence  to  the  serving  host. 


telnet   SYNCH 


C  •  i  o  s  t  n  a  m  e  3  Z  <  p  a  r  a  m  p  t  e  r  s  >  3 

Attempts  to  open  the   requested 
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connection   to   a 
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'telnet*  (and  its  synonyms) 
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are   syntactically   identical;   however/-  to  open  a 
connection/  a  host  must  t>e  specified. 

Host  switches  take  additional  o  r  g  u  me  n  t  ( s  ) 
which  are  usually  i  n  t  e  g  e  r  (  s  )  .  Telnet  will  inter- 
pret any  integer  as  decimal/  unless  the  first  di- 
git is  a  *0*  -  in  which  case  it  will  be  interpret- 
ed as  octal.  Switches  and  their  arguments  (with 
integers  represented  as  *#')  are: 


-a  n 


desired  message  allocation  si2e 


-d  #  #  specifies  a  direct  connect  (as  op- 
posed to  normal  ipc)  foreign  socket.  a 
36  bit  quantity  which  is  specified  as 
two  16  bit  integers/  high  order  portion 
first.  usually/-  one  wants  the  s  switch/ 
not  this  one . 

-  h  #  host  number  of  the  desired  host 
(use  without  the  hostname) 

-s  #  foreign  socket  to  connect  to  (de- 
fault is  1) 

-t  ft  number  of   seconds   before   timeout 

(default  120) 

2.2.6   Local  telnet  control  and  help  function  commands 


Cset3      charmode 

Charmode  forces  telnet  to  send  each  character 
typed  to  the  net  immediately  (exception:  see  the 
"escape*  command).  See  the  elaboration  of  connec- 
tion modes.   (Stction  2.3.2) 


commands 


Types  a  list  of  all  the  command  keywords  known   to 
te I  net  . 


■C-CCset3    display    <c>  "string"  >> 

Establishes  a  correspondence  between  a  character 
<c>  received  from  the  net  and  an  arbitrary/  user- 
defined  character  string.  Maps  the  receive d  char- 
acter into  the  specified  string  for  typing  on  the 
terminal  . 


CsetJ      echo       <mode> 

Controls  local  echoing.   The  mode  setting   is   ei- 
ther  'on'  or  *off*;  initially/  echo  is  turned  on. 
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Note:  setting  the  local  echo  takes  place  immedi- 
ately and  remains  in  effect  until  countermanded. 

Cset  3  eli  ne      L<c>D 

If  the  optional  argument  is  present/  the  endline 
chiracter  is  set  to  the  first  character  of  the  ar- 
gument. Whether  or  not  the  argument  was  present 
the  now-current  setting  of  the  endline  character 
is  typed.  The  endline  character  is  the  character 
upon  which  a  line  ot  text  is  sent  to  the  serving 
host,  f.'ote:  this  function  is  only  useful  in  mes- 
sage mode  (see  below)/  as  each  character  is  sent 
immediately  in  charm  ode/-  and  the  endline  character 
is  system -defined  in  Linemode.  Default  endline 
character  is  sy s t em -de f i ncd  (but  usually  newline 
or  carriage  return). 

Cset3     escape     C<c>3 

If  the  optional  argument  is  present/  the  escape 
character  is  set  to  the  first  character  of  the  ar- 
gument. Regardless  ot  the  presence  or  absence  of 
the  argument/  the  current  setting  of  the  escape 
character  is  then  typed.  If  the  first  character 
on  a  line  is  the  escape  character  while'  a  connec- 
tion is  open/  the  rest  of  the  line  is  interpreted 
to  he  a  telnet  command.  The  default  escape  char- 
acter is  *  "  * . 

help     [<keywords>3 

Invokes  the  help  function  to  tell  you  some  useful 
things  about  the  keyword (s)  specified.  If  a  key- 
word is  unrecognized/  or  no  keyword  is  specified/ 
instructions  for  using  the  h  e  t  l>  command  are  given. 


hosts 


Produces/  on  the  terminal/  a  brief  list  of  all 
known  network  host  names.  If  the  host  is  up  (to 
the  best  of  the  NCP's  knowledge)/  the  name  is  fol- 


lowed  by  a  * "  •  character, 
r u n s  the  hosts  program). 


(This  command  jctually 


UCset:) 


Cset] 


key        <c>  "<strinj>"  >> 

NOTE:  this  feature  is  not  yet  implemented/  but  if 
the  description  interests  you/  see  where  the 
'load*  command  leads  you. 

Establishes  a  mapping  between  a  certain  keyboard 
character  <■  c  >  and  an  arbitrary  string.  When  key 
<c>  is  typed/  the  user- defined  string  will  be  sent 
to  the  server/  not  the  nctual  key. 

I inemode 
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Csetl 


msgmode 

Puts  telnet  into  message  mode.  In  this  m  o  d  e  *>  tel- 
net waits  for  the  settable-endline  character  (see 
'endline*  command)  before  sending  any  characters 
to  the  server.  In  other  words/  it  allows  one  to 
send  line-at-a-time  messages  to  the  server  and 
choose  the  endline  character  too.  For  further 
discussion^  see  the  elaboration  of  connection 
modes  . 


Cecho] 


CechoD 


off 


on 


Turns  local  echoing  off 
m  a  n  d  . 


Turns  local  echoing  on. 
m  a  n  d . 


See  also  the  'echo'   corn- 


See  also  the  'echo'   com- 
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set      <  c  m  d  >  <  a  r  g  s  > 

This  command  is  a  prefix  to  many  other  commands 
(i.e.  *c  harrnode '  /  'escape')  and  is  provided  for 
naming  clarity.  Usually  it  is  not  nccessjry/  hut 
is  helpful  to  the  novice  .'or  the  soke  of  mnemonic 
commands. 


settty 


This  command  does  nothing  to  the  terminal/-  as  the 

name   implies   -  it  tyres  out  telnet  terminal  mode 

information  and  is  used  soley  for   debugging  tel- 
net. 


status 


[<hostname>3 

To  inquire  about  a  host's 
command.   If  the  hostname 


co mm ana.   it  tne  nostname  is 
the  IMP/interface.  hardware  is 


status   one   uses   this 
is  absent/-  the  status  of 


given 


CsetH 


tenex 


Purely  a  convenience  commands  this  puts  the  termi- 
nal into  charmode  with  local  echoing  off  -  t he- 
preferred  mode  for   TENEX   connections.    See   the 


*charmode*   and   *echor  co  mm  anus.'  and 
tion  on  connections  for  more  detail. 


the  e  t  a  b  o r a 


wait     <nsecs  > 

Causes  telnet  to  suspend  keyboard 
the   specified   number  of  seconds, 
integer).   Useful  for  Ingoing  into 
via  a  character  mapping  trick  (see 
for  the  *  m  k  c  h  a  r  m  a  p '  program). 


p recces- ng   tor 
( <  n  s  e c  s  >  is  an 

a   remote   host 
the  manual  page 


2-3   Elaboration  on  Some  Concepts 

This  section  provides  a  semi-detailed  discussion  of  some  of 
the  concepts  involved  in  operating  user  telnet.  These  discus- 
sions are  intended  for  the  novice  to  skim/-  a n o  then  reread  at  a 
later  date/-  after  having  a  bit  of  experience  with  telnet.  '.ot 
all  of  the  information  here  will  be  useful  initially/  but  the 
general  ideas  are  useful  for  deciding/  for  example/  the  terminal 
mode  you  wish  to  operate  in.  Particularly  recommended  for  the 
novice  are  the  discussions  of  connections  and  terminal  modes/ 
with  protocols  running  a  very  close  second. 

?  .  3  .  1   Connections 


When  you  tell  user  telnet  to  connect  you  to  a  foreign  host/ 
and  the  connections  goes  thru/  you  probably  don't  even  consider 
how  it  works.  Mere  will  be  a  much  simplified  explanation  of  the 
mechanism  of  connecting  to  another  host  on  the  net.  Actually/ 
the  matter  is  conceptually  quite  simple:  telnet  requests  that  the 
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ndl/  and  kill  the  user  telnet  process  because  it's  managed  to  net 
itself  "hung*.  This  is  most  certainly  NOT  the  case.  You  have 
connected  to  someplace  that  dues  not  have  a  server  listeninn  and 
so  absolutely  nothing  will  happen  on  the  connection.  This  is  the 
main  hazard  of  the  "  - s '  parameter. 


However/  the  *-s'  switch  has  several  good  uses.  The  normal 
user  would  not  need  to  connect  to  a  special  socket  for  testing  a 
new  version  of  a  server/  but  may  wish  to  use  another  facility  of 
a  remote  host.  For  example*  the  well  known  socket  for  FTP  (the 
file  Transfer  Program)  is  socket  three.  One  could  use  telnet  to 
connect  to  a  server  FTP  in  order  to  send  network  mail/  if  the 
user's  site  lacks  a  specific  network  mailer.  Some  sites  may  have 
additional  special  programs  or  experimental  services  running  on 
advertized  sockets  that  one  may  wish  to  access. 

2.3.2   Local  terminal  and  connection  modes 

There  are  several  modes  available  for  communication  with  a 
foreign  host  once  you've  opened  a  connection.  K  a  c  h  mode  deals 
with  when  characters  are  transmitted  from  your  local  computer  to 
the  servim  host.  Further/  you  have  control  over  some  of  the  lo- 
cal modes  that  your  terminal  can  be  set  into.  These  two  func- 
tions are  quite  orthogonal/  so  we'll  take  the  easiest  first. 
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Talking  to  the  foreign  host  can  be  done  various  ways.  You 
can  have  the  system  save  the  characters  you  tyue  until  you  finish 
the  line  (by  typing  the  system -defined  end-line  character  (usu. il- 
ly a  newline  or  carriage  return)  )/  at  which  point  the  system 
gives  the  line  to  telnet  for  transmission   to  .the   foreign   host 
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(line  mode).  The  other  e  x  t  r  e  m  (■  is  to  have*  the  system  give  telnet 
every  character  you  type  immediately  so  telnet  can  transmit  char- 
acters to  the  network  as  s?on  as  yo'u  type  them  (charmede).  A 
compromise  is  also  available:  have  the  system  nive  each  character 
to  telnet  immediately/  hut  have  telnet  save  up  whole  lines  and 
transmit  them  when  you  type  a  self-defined  end-line  character 
(msqmo'rJe )  . 

Each  scheme  has  it's  own  ad v  a  n  t  a  q  e  s  in  certain  cir- 
cumstances. Linemode  is  the  most  efficient  to  use  (because  you 
bother  telnet  the  least/  and  transmit  to  the  network  the  least 
which  produces  a  savings  in  the  overheads  required)/  but  you 
can't  define  your  own  end-line  character  and  can't  effectively 
use  programs  that  act  on  single  keypresses.  "is  g  mo  vie  bothers  tel- 
net for  every  character/  but  won't  transmit  to  the  serving  host 
until  you  type  the  end-line  character.  This  reduces  the  overhead 
in  writing  to  the  network/  but  causes  lots  of  overhead  in  bother- 
ing telnet  with  input  characters.  Charm ode  is/  then/  the  most 
gluttonous  of  all  three  as  it  Pothers  telnet  for  each  character 
and  then  writes  single  characters  to  the  network. 


However/  one  can  take  a  slightly 
matter.    Many   computer   systems   do 
user  telnet  does  not  do  (for  example/ 
look  inn   like  "C )  which  make  en  arm  ode 
use.   Since  linemode  and  msgmode  are  s 
until   you  type  an  end-line/  the  local 
and  you  lose  any  such  character  transl 
type  of  facility  nay  make  one  feel  iso 
puter.   This  isolation  fro;r.  the  host 
connection   feel   somewhat   'rubbery' 
lots  of  people  find  disconcerting/  if 


di  f f erent 
character 
making  c  o n 
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a  v  i  n g   up 

telnet  m  u 
at  ions.  T 
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view  of  t 
t  r  3ns  I  at  i 
trol-c  c 
contusing 

your  c  h 
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makes  t  h 
troll  able 
g  h  t  annoy 


he  whole 
ons  that 
o  m e   out 

mode  to 
aract  ers 

echo  i  n y 
of  t  In"  s 
ion  c  o  m  - 
e   whole 

-  which 
i  ng  . 


In  Summary/  the  mode  you  choose  is  purely  a  matter  of  per- 
sonal preference.  If  the  machine  you  connect  to  does  not  reqjire 
char  mode/  linemode  is  your  best  bet  because  it  will  cause  less 
load  on  your  local  system.  However/  it  you  use  a  system  like  a 
TENCX/  you  will  probably  be  miserable  if  you're  not  in  char  mode. 
As  a  matter  of  fact/  there  is  a  convience  mode  created  especially 
for  T  L  \  E  X  systems  called  (what  else)  'tenex'  .  This  mode  is  a 
faster  way  to  say  *  c  h  a  r  t  c  u  e  '  with  'echo  off'  (so  the  TEN  EX  does 
the  echoing/  funny  translations  and  all). 

2.3.3   Telnet  Protocols  and  Options 


The  user  telnet  program  communicates  with  the  server  over  a 
logical  network  connection.  User  telnet/  located  in  the  computer 
you  are  connected  directly  to/  provides  you  the  interface  to  the 
network.  Commands  to  user  telnet/  as  explained  earlier/  control 
either  your  interface  to  the  network  or  the  interface  from  the 
network   to   your   host   computer  (thru  the  telnet  server  located 
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there). 

Of  course/  the  server  and  user  telnet  programs  m.-iy  exchange 
status  information/  alert  each  other  to  special  conditions/  or 
make  special  requests  about  the  connection  to  each  other.  In 
order  to  accomplish  these  tasks  both  programs  must  have  an  agreed 
upon  set  of  rules  -  a  protocol  -  that  each  follows  to  understand 
the  other's  special  messages.  The  full  telnet  protocol  is  quite 
versatile  arid  easy  to  use.  Unfortunately/  most  telnet  programs 
(user  and  server  alike)  friil  to  implement  the  entire  set  of  pro- 
tocol requests  due  to  many  and  varieo  reasons. 
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What  are    the  command  requests  for? 
you   to   control  t 1 1 e  program  that  you're  r 
puter  with  greater  accuracy  that   would   o 
When   you   send  a  protocol  message/  you  ar 
the  remote  host  (the  server)  that  it  must 
you   woutd  tell  the  server  to  interrupt  th 
ning  or  threw  away  the  outfut  from  it.   Th 
complished   with   the  telnet  ip  (interrupt 
output)  respectively.   Other  functions  of 
synch   sequence   (used  to  synenronizethe 
when  some  trouble  is  experienced  with  the 
are-you-the re   function   (which   asks   the 
still  up  and  running 7. 


Basically/  they  a 
unninq  at  the  host 
ther wise  be  possi 
e  telling  the  telne 
do  s o m  e  t  h  i  n  j  .  Comm 
e  program  you  have 
ese  functions   are 

process)  and  ao  (a 
this  type   include 
server  and  user  tel 

connection)/   and 
foreign  host  if  i 


I  low 
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only 
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the 
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C6D  Unfortunately/  such  requests  must  be  sent  literally 
via  the  send  command/  which  requires  knowing  the  numeric 
values  of  the  telnet  protocol  commands.  All  would  be  fine 
if  only  Unix  had  a  viable  IPC  facility/  as  each  process 
cannot  know  what  the  other  is  do  inn. 


Telnet  Manual 


1« 


t  her 
ty* 

t  ron 

ve  rt 

supp 

the 

user 

cont 

(or 

term 

term 

not 


Op 
e  a 
and 
sm  i 
i  c  a 
or  t 
man 
t 
rol 

it 
i  no 
i  n.^ 
i  rnp 


t  i  on  n 
r  e  a  b  o 
the  I 
ss  i  <>n 
I  tab 
SUCh 

ner  t  h 
e  I  n  e  t  . 
I  i  n  o 
self  ) 
I  /  n  e  i 
I  is 
lenf.'nt 


e  f;ot 
ut  2 
ist 

of 
sett 
), 

at  c 

T 

f  ec 

tel 
t  her 

ao  i 

inns 


i  a  t  i  o  n  s 
1  ttlne 
g  rows 
binary 
i  n  g  s  (  f 
and  pr 
haracte 
he  m  o  s 
ho.  hi 
I  you  w 
of  the 
ng  it  f 
t  opt  io 


a  r  e 

t  opt 
com  i 
i  n  f  o  r 
or  t  h 
ovi  di 
rs  yo 
t  CO 
t  her 
h3t  y 
t  eln 
or  yo 
ns/  d 


c  n  n  s  i 
i  ons 

nuous 
mat  i  o 
OSf  t 
n:;  f  o 
u  t  yp 
mron/ 
t  e  I  ri  e 
ou  t  y 
et  s  a 
u). 
ue  to 


der.i 
deti 
ly. 

r. /•  s 
erni  i 
r  th 
e  a  r 

of 
t  ca 
ped . 
re  e 
Unfo 

lac 


bly 

ned 

et  ti 
n  a  I  s 
e  se 

e  e  c 
cour 
n  re 

If 
choi 
rtun 
k  of 


m  o  r  e  e 
in  the 
ong  t 
ng  of 

t  hat 
rv  i  no 
hoed 
se  /■  is 
quest 
you're 
ng  wha 
ate [y, 

IPC. 


xo  1 1  c 

n  e  t  w 

he   o 

ho  r  i  z 

have 

t  c  I  n  e 

to   y 

p  la  i 

that 

on  a 

t  you 

user 


.  Cu 
ork  c 
p  t  ion 
ont  o  I 
h  o  r  d  k 
t  to 
ou  b 
n  and 
the 

hal  f 
typ 

tele 


rrent t  y 
o  rn  m  u  n  i  - 
s   are: 

and/or 
a  r  e  to 
cont  r  o I 
y   your 

simple 

o  t  h  e  r 

-duplex 

e   (the 

nt  does 


2.4   Illustrative  examples 


This  section  will  present  some  examples  of  using  telnet. 
The  examples  are  taken  f  ran;  typescripts  of  actual  sessions  at  the 
terminal.   However^  they  h<jve  been  edited  in  some  cases  to   trun- 


cate outputs  *hich  would  not  fit 
add  materially  to  the  usefulness 
starts  with  a  "'/.",  the  rest 
shell.  Comments  which  have  been 
"CC"  and  "33". 


in  the  document  and  which  do  not 

of  the   example.    When   a   line 

of  the  line  was  typed  to  a  Unix 

added  later  are   bracketed   with 


2.4.1   Simple  Connection 

The  following  illustrates  the  minimal  commands  necessary 
make  a  network  connection. 


to 


%  te 
Uni 
"  e 
Esc 
$  : 
$  : 
$  : 
$  : 
?.  m 

was 
$  : 
$  c 
Att 
J  nt 
$  : 
$  : 
$  t 
3.  c 
Att 
Con 


Inet 

x  us 

sc  S 

ape 

wil 

uni 

whi 

whe 

esq 

y 

wil 
onne 
e  r  p  t 
erru 
got 
t  ry 
enex 
onne 
empt 
nect 


er  telnet  —  Version  4.0  (11.57) 

character  is  $ 

I  turn  off  messaoes  to  prevent  confusion 

x  treats  lines  starting  with  colon  blank  as  comment 

le  not  connected/-  telnet  puts  esc  char  as  prompt 

n  connected  to  other  host/  i  have  to  type  it 


I  now  try  connect  to  same  system 

c  t  i  I  I  -  u  n  i  x 

in-,  connection  to  ill- u nix 

p  t  e  d  -  a  b  o  r  t  a  1 1  e  m  p  t 
tired  of  awaiting  timeout/  hit  rubout 
a  different  host/  this  tirre  a  tenex 

c t  bbn 

ing  connection  to  bbn 

ion  open  (char mode) 
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OHN- 
SLOGJ 

•7 

SLOG  I 

(USER 

(PASS 

(  A  C  C  0 

J  Ob 

PREV 

TCNE 

due 

5)S  :  n 

$ 
DIR 


13*  BDN-SYSTEK-C  EXEC  1.54.55 


TEN  EX  1.34 
N  KELLEY 

fJ 

)  KELLEY 

WORD) 

UNT  #)  111641 

30  ON  TTY3/  9-May-78  15:16 

IOUS  LOGIN:  9-May-78  01:16 

X  will  go  down  Wed  5-10-78 

to  scheduled  hardware  work 

o w  whatever  i  type  goes  to 


0400  til  Wed  5-10-78  0800 

by  SPEAR 

bbri/    unless    preceded    by    $ 


<KELLEY> 
/U  N  DELIVER  A  BL  E -MAIL/. wylieiii  USC— I  SIC;  1 

message.txt; 1 

3arc hi ve-0irect0ryc.;1 

£)$:  the  content  of  those  files  is  of  little  interest 

$ 
LOGOUT 

TENEX  will  -jo  down  Wed  5-10-78  0400  til  Wed  5-10-78  0800 

due  to  scheduled  hardware  work  by  SPEAR 

KILLED  J03  30*  USER  KELLEY*  ACCT  111641*  TTY  37*  AT   5/09/78  1545 

USED  0:0:19  IN  0:28:28 
$c lose 


Conn 

Lin 

$  : 

CCTh 

in 

is 

pa 

$  c 

Att 

Con 

UCLA 

VERS 

ENTE 

help 


ect  i  on 
e  m  o  d  e 

when 
ere  is 

this 

si  mp  I 
ranete 
onnect 
erupt  in 
nect  i  o 

CCN  3 
ION  4. 
R  CO  MM 


CI osed 

the  connection  is  closed  you  go  back  to  linemode 
no  logical  reason  for  changing  escape  character 

circumstance*  just  did  it  for  example.  Next  part 

e  connection  to  another  site*  but  using  timeout 

r  in  case  they  are  not  responding  well.         33 
ccn  -t  1 0 

■t  connection  to  ccn 

n  open  (linemode) 

,'0/91  Sf-RVER  TELNET 

0  12/76  (NEW  TELNET 

AND  OR  'HELP '  : 


PROTOCOL) 


Commands  available  are 


Servi  ce  —  Desc  ript  ion 


RJS EhCDIC  remote  job  submittal  service 

ARJS ASCII  remote  job  submittal  service. 
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TTYRJS.. .Alternate  ASCII  RJS  for  a  model  33  TTY. 
bii  0  A  R  0 .  .  •  B  u  1 1  \~.  t  i  n  b  o  <*  r  cJ  n  o  t  i  c  e  s  of  iener.il 

interest  to  C  C  N  users. 

TSO Access  to  IBM  TSO  time  sharing  system. 

NETS  TAT. .Give  status  o  f  users  cor1  nee  ted  to  CCN's 

NCP.  Lists  status  of  the  protocols. 
HELP  s.. .Produces  information  about  a  service 

where  * s'  is  a  service  name. 

END Disconnect  from  CCN's  server  telnet. 

QUIT Same  as  CND. 

CLOSE Same  as  END. 

OPR S  •:■  n  d  n.  ess  ages  to  the  operator.  Note 

for  reply  use  TSO  M S 6  or  N E T  MAIL. 

Commands  except  for  HELP  have  no  operands  but 
must  be  followed  by  a  CR/LF.  Any  nonambi guous 
abbreviation  for  a  command  is  acceptable.  For 
further  information  about  C  C  N  services/ 
call  (213)  825-7548. 

ENTER  COMMAND  OR  'HELP': 

$:  it  is  rather  nice  of  them  to  keep 

$■ 
$ :  help  stuff  on  left  side  of  screen 

$ 
$c  lose 

Connection  Closed 
$  $ 

$  :  now  that  i  am  not  connected  i  do  not  need  the  escape  ch 
$  :  my  close  did  the  same  as  their  end  would  have 
$  status 

type   hostname   user-id  p-id  fileid  usr  state   status 


PECV     anyhost      NCP     0 
RECV  bbn-tcnexb    rr.arty  28736 
SEND  bbn-tcnexb    marty  22N31 
RECV  bbn-tcnexb     wait  24071 
SEND  bbn-tenexb     wait  18450 
SICP     anyhost      NCP     0 
RECV  bbn-t<?nexb    marne  16163 
SEND  bbn-tenexb    marge  22280 
SICP     anyhost      NCP     0 
SICP     anyhost      NCP     0 

$  conn  dt  i  -t  10 

Attemf.it  in  g  connection  to  dti 
Open  fails:  I / 0    error 

$  :  that  is  the  condition  you 

S  tenex 

$  conn  bbn 


4  0  44C  NCP 
3  7440  USR 

3  7440  USR 

4  012  0  USR 
40120  USR 

37  7  30  NCP 


LIMBO  Unknown 
OPEN  Data  Wait 
OPEN  Just  got  ALL 
0PF.  N  Data  Wait 
0  P  h N  Just  got  A L  L 
LISTEN  Unknown 


4  00C0  USR    GPfcN  Data  Wait 
40000  USR    0PFN  Just  got  cLL 
4C210  NCP  LISTEN  Unknown 
40370  NCP  LISTEM  Unknown 


get  on  timeout  of  attempt 
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Attempting  connection  to  bbn 
Connection  open  (char mode) 


BBN-TENEX 
b)$st  atus 


1.34.13/  BBN-SYSTEM-C  EXEC  1.54.55 


type   hostname   user-id  p-id  f i I v i d  usr  state   status 


RECV 
RECV 
SEND 
RECV 
SEND 
SICP 
RECV 
SEND 
SICP 
SICP 

$ 
$ :  note 

$ 


an /ho st 
bbn-tene x  b 

bbn-t cne xo 

bbn-tene xb 

bbn-tcnexb 

anyhost 

bbn-t en ex 

bbn-tene  x 

anyhost 

anyhost 


NCP 

ma  rt  y 

ma  rt  y 

wait 

wait 

NCP 
karl 
karl 

NCP 

N  C  P 


0 
28736 
22^31 
24  071 
184  50 

0 
1591  7 
225 

0 

0 


4044  0  NCP 
37440  USR 
37440  USR 
40120  USR 
4j120  USR 

37  73  0  NCP 
4 01  GO  USR 


40100 
40  21  0 
4015  0 


USR 
NCP 
NCP 


L  I  H BO  Unknown 
0  P  t  N  Data  Wait 
0PI1N  Just  got  ALL 
0  P  r  N  D  b t  a  Wait 
OPTN  Just  got  ALL 

LISTEN  Unknown 

OPEN  Data  Wait 
OPEN  Just  not  ALL 

LISTEN  Unknown 

LISTEN  Unknown 


that  i  am  now  owner  of  two  simplex  connections 


2.4.2   Specific  Sockets 

The  following  illustrates  a  connection  to  a  specific  socket 
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p  e  c  i  a  I 
need  a 
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is  to 
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mail 
e  May 
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onnec  t 
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FTP  S 


connecting  to  specific  sockets  allows  one- 
services  on  other  sites.  The  following  is 
s  a  wa;  to  send  mail*  because  a  program 
ally  does  it  for  you  and  does  a  better  job. 

illustrate  specific  socket  connection.  Do 
socket  without  knowing  precisely  what  that 
to  appear  on  the  line  (else  bad  results). TU 
9  16:04:50  1 978 

9  16:15:46  197o 

ion  to  L  b n 

i  nerrode ) 

ervice  2.9.0  257  at  Tue  9-May-7tf  17:20-EDT 


/.  ended  by  a  line  with  only  a  " . 
t  message/  snt  as  part  of  ex amp  I 
leted  successfully. 


session 


Connect  ion  Closed 

EC Now  that  the  connection  is  closed*  we  can  connect  in  the  normal 
way  to  read  the  mail  we  just  sent.  2  2 

*  con  bbn 
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Attempting  connection  to  bbn 
Connection  open  (line  rri  ode) 


BBN 

oi'te 

Cha 

LOSI 

JOB 

PRE 

TEN 

due 

CYO 

SREA 

READ 

TYPE 

* 

Mail 

this 

&>L06 

TEN 

due 


-TEN  EX 
nex 
r  ri  o  d  e 
N  KELL 

38  ON 
VIOUS 
EX  w  i  I 

to  sc 
U  HAVE 
DMAIL 
MAIL  2 

?  FOR 


1.34.13/  UBN-SYSTLM-C  E>EC  1.54.55 


EY   111641 

TTY57  9 -May -78  17:2? 
LOGIN:  9-tfay-78  15:5ft 
I  90  down  Wed  5-10-78 
heduled  hardware  work 

NEW  MAIL3 


0400  til  Wed  5-10-/8  0800 
by  SPEAR 


t  (15) 
HELP 


from  ILL-UNIX  rcvd  at  9-May-78  1720-EDT 

is  a  test  message^  snt  as  part  of  example  session 

OUT 

EX  will  go  do^n  Wed  5-10-78  04  10  til  Wed  5-10-78  0800 
to  scheduled  hardware  work  by  SPEAR 


KILLED  JOB  38/  USER  KELLEY/  ACCT  111641/  TTY  37/  AT   5/09/78  1725 

USED  0:0:3  IN  0:3:16 
"close 

Connect  ion  Closed 
Line mode 
bye 
% 

2.4.3   Connecting  to  Another  Unix 

The  echo  off  command  can  be  used  to  hide  a  password;  the 
stty_echo  command  at  a  remote  Unix  system  can  be  used  to  turn  off 
re  mote  echo. 


%  con  dt  i 
Attempting  connection  to  dti 
Connection  open  (line mode) 

>>>  ENFE  Server  Telnet  <<< 

New  Protoco I 

Digital  Technology  Unix 

Lov>in:  kck 

kck 

Password:  "echo  oft 


X    echo  on 
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st  t  y  -echo 
St  t  y  -^cho 
%  who  am  i 

kck      ttyX  May  10  20:45 
Z  cat  /etc/motd 

?6Apr7tf        Ok/  guys.   Time  to  clean  house.   Disk  space  is  really  low 
on  rp5 . 

30Apr78  HEY/  FOLKS/  We're  down  to  1500  blocks  on  rp5. throw  things  out 

or  they  will  disappear  mysteriously. 
%     "cat  /etc/motd 

10May78  HASP  Off  while  debugging  subsystem  problems. 

DOWNTIME:  possibly  thurs  5/11  0930-????  for  new  AED  disk  install 
Please:  NO  net-mail  to  C^UA  until  further  notice  (Dalocca) 
Congratz  to  Diane/  Tom/  &  Kichael  Plilke  (7/.J6oz:  1030  Thurs.) 

% 

2.4.4   Multiple  Connections 

The  capability  to  work  with  two  open  network  connections 
does  not  really  exist  on  this  system.  However/  because  Unix  will 
allow  the  user  to  run  a  program  os  a  subshell/  it  is  possible  to 
put  one  connection  on  "hold"  while  running  a  second  embodiment  of 
telnet.   This  is  not  advised  for  the  Unix  novice. 


CCThe  next  example  is  only  for  people  familiar  with  unix.  Since 
the'  unix  telnet  program  allows  the  user  to  run  any  program  as 
a  forked  off  shell/  and  since  telnet  is  itself  a  program/  then 
if  I  know  the  full  pathname  of  the  unix  telnet  program...      33 


by  the  following  trick 


S:  i  can  get  a  second  connection  going 

J 
$/usr/ 1: in/telnet  b b n 

Attempting  connection  to  bbn 

Connection  open  (line mode) 

BBN-TENEX  1.34.13/  BBN-SYSTEM-C  EXEC  1.54.55 
EC  Now  of  course  I  cannot  in  any  way  get  the  attention  of  the 

first  telnet  program  I  was  running  until  I  completely  exit 

this  one.  33 

qJloginkelley 
LOoIN  KELLfc  Y 
(PASSWORD)  applesauce 
CtJ  forgot  to  turn  echo  off  so  my  password  showed  up.  The 

command  "ten ex  should  have  pre c ceded  the  connect  command. 

However/  since  I  am  editting  in  these  comments/  wh<it 
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really  appeared  there  has  been  chanqed  to  applesauce.    3  3 

(ACCOUNT  //) 
111641 

JOG  2  ON  TTY5G  9 -May- 78  15:53 

PREVIOUS  LOGIN:  V-May-78  15:16 

TCNfcX  will  cjo  down  Wed  5-10-78  0400  til  wed  5-10-/8  0800 

due  to  scheduled  hardware  work  t-y  SPEAR 
S":  now  i  am  in  a  subordinate  shell  running  another 

":  copy  of  telnet/  no  relation  to  the  first/  soon 

AUTOLOGOUS 
KILLED  JOB  26/  TTY  4 5 /  AT   5/09/78  15  59  . 

USED  0:0:1  IN  0:3:3 

Connection  aborted 
* :  i  should  see  (I  just  did  see)  evidence  that  first 

m :  connection  attempt  failed  cause  i  did  not  login 

" :  mi  ght 

* :  now  when  i  close  this  connection  and  say  bye  i  will  be 

* :  back  to  the  in itial  embodiment  of  telnet 

logout 
LOGOUT 

TENEX  will  go    down  Wed  5-10-78  0400  til  Wed  5-10-78  0800 

due  to  scheduled  hard k are  work  by  SPEAR 

KILLED  JOB  2/  USER  KELLEY/  ACCT  111641/  TTY  50/  AT   5/09/78  1602 

USED  0:0:2  IN  0:3:14 
"bye 

Connection  Closed 

$ 
CCfJow  I  am  back  to  the  original  telnet  session/  but  the  connection  I 
had  open  to  bbn  is  closed  because  of  the  autologout.  33 

2.4.5   Using  Send  Co mm  and 

The  following  session  is  an  example  of  the  necessity  and  use 
of  the  send  command. 


X     :  session  to  illustrate  usefulness  of  send  command 
X    con  bbn 

Attempting  connection  to  bbn 

Connection  open  (line mode) 
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BBN-TtNEX     1.34.15/     BBN-  S  YST  LM-C     fcXCC    1.54.55 
U  *  t  e  n  e  x 

C  h  a  r  hi  o  cJ  e 
LOulN    KELLLY        111641 

JOD    27    ON    TTY3/    12-May-78    11:59 

PREVIOUS    LOGIN:    9-May-78    17:?2 
ftSEN~ll    ? 
USN'DMSG 

To    (?    for    help):    K  ARLaiLL-UM  X 

cc     ( ?    for    m e I p) : 

Subject:  EXAMPLE  MESSAGE 

Messaoe     (?    tor    help): 

WHILE     TYPING    TlilS     EXAMPLE     IN    UNIX/    THE    AT     SIGN     IN     THE        TO 

LINE     H<\D     TO    BE 

**PRECEEDED  BY  A  BACKSLASH.  EVEN  IN  CHARMODE  THE  UNIX  HANDLING 

OF  SPECIAL 

**  CHARATERS   SRETAACTERS  IS  IN  EFFECT. 

HOWEVER/  IT  WOULD  SEEM  THAT 

**  ON  THE  EsB.N  SYSTEM  THE  LINES  ARE  ALL  BEING  TREADED   DETESSD 

AS  THOU 

**6H  I  WAS  NOT  PUTTING  CARRIAGE  RETURNS  AT  THE  END. 

TO  PREVENT  INTER  FERE N 

**CE  WITH  ITS  SPECIAL  FUNCTION  IN  THIS  S CR I P T -PR  0 D U C I NG 

MODE/  I  WILL  SEN 

**D  THE  REQUIRED  CONTROL-Z  USING  THE  SNED  COMMAN D D N AMMOC  DENE 

**ND  COMMAND. 

"send  Iz 

*Z 

Q/S/? /carriage-return:  Send 

KARL  at  ILL-UNIX  —  ok 
SLOGOUT 

KILLED  JOE  27/  USER  KELLEY/  ACCT  111641/  TTY  37/  AT   5/12/78  1216 

USED  0:0:6  IN  0:17:33 
"close 


Connection  Closed 
L  i  n  e  m  o  d  e 
"  bye 

X    mso, 

10  messages  in  ./mailbox 
for  help  type  ? 
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<-  tyre  10 

Message  10  has  671  bytes/  17  lines 
Times  tamp:  Network  mail  from  host  bbn-tenex  on  Fri  May  12  11:14:3' 
Date:  12  fay  1 V / 8  1  2  1  5  -  E  D  T 
From:  KfcLLLY  at  BBN-TENEX 
Subject:  EXAMPLE  MESSAGE 
To:    KAPL  at  ILL-UNIX 


WHILE  TYPING  THIS  EXAMPLE  IN  UMX/  THE  AT  SIGN  IN  THE   TO 
LINE  HAD  TO  BE  PPECEEDED  BY  A  BACKSLASH.  LVEN  IN  CMARHODE  THE 
OF  SPECIAL  CHARACTERS  IS  IN  EFFECT. 


UNIX  H  A  N  L 


HOWEVER/  IT  WOULD  SEEM  THAT  ON  THE  BBN  SYSTEM  THE  LINES  ARE  ALL  BEING  T 
AS  THOUGH  I  WAS  NOT  PUTTING  CARRIAGE  RETURNS  AT  THE  END. 

TO  PREVENT  INTERFERENCE  WITH  ITS  SPECIAL  FUNCTION  IN  THIS  SCRIPT-PROD UC 
MODE/  1  WILL  SEND  THE  REQUIRED  CONTROL-Z  USING  THE  SEND  COMMAND. 


% 
% 
% 
% 
% 
% 
% 

U 
he 


-  Network  mail  transmission  ended  on  Fri  May  12  11:14:43   

quit 
:  my  typing  skill  was  not  too 
:  the  *  *  i  n  front  of  lines  prod 
:  forced  the  line  to  end. 
:  However/  note  that  in  the  re 
:  end  of  cxamole 


impressive  in  this  message. 

uced  in  sno'msg  indicate  where  they 

suits nt  mail/  lines  end  correctly. 


te I  net 
nix 


user 


help 


in 
a 

ma 


ab 
t  i 
co 


tro 

c  o  m  m  a  n 

nds  .33 

help 

help 

co  mm 

host 

le  Sev 

ons/  e 

minnnd. 

a)  Opt 

b )  Com 
par 


c) 


Par 

ang 


d/  so 
I nt  rodu 

<cmd> 
ands 
s 

er?l  s  ho 
spec  i  a  I  I 

T  h  e  s  e 
iona  I  it 
mand  syn 
anct  e  r s/ 
a  in  e  t  e  r  s 
I e  brack 


e  Inet 
[abrevi  a 
[<key 
nvokes  t 
h  i  n  g  s 
eywo  rd 
pecified 
re 


c t  i  on  to 

to  ge 

for  a 

for  a 

for  a 

r t  hand  n 

y   in  t  h 

are: 

e  '^  s  are 

tax  line 

;.  n  d  all 

are  u s  u  a 

ets  <"<" 


Ver 
t  i  on  of 
wor d>3 
he  help 
3  b  o  u  t   t 
is   unre 
/  i  ns t  ru 
gi  ven. 


user  t  e 

t  this 

ries  c  r i  p 

list  n f 

list  of 

ot  at  i  ons 

e  line  g 

e  n  c  I  o  s  e  d 
s  list  t 


si  on     4.0 
help  help J  3 


(II  .37) 


he 


function  to  tell 
he   keyword   spe 
coqnized/   or 
ctions  for  usinq 

h 

youqet  inform 
Inct  help  functi 

tion  of  specif ie 
the  command s  av 
the  possible  h 
are  used  in  the 

iving  the  valid 

in  square  brack 
ho   entire   comm 


you  some  useful 
ciiied.  If  the 
no    keyword    is 

the  help  command 
e  Ip        ga  rbage 

[[Neither  k e y  is 
a  t  i  o  n  about  c  o  m - 
ons  .     Ty pe  : 

d  command 
a  i  I  a  b  I  e 

ost- names   avail- 
command  d  e  s  c  r  i  p  - 
s  y  n  t  a  x   for   e  a c  h 

ets  ("["/  "3") 
and   -   prefixes/ 


11  y  specified  by   mnemonics   enclose d   in 
/  M>") 
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d )  Un implemented  commands  ore  enclosed  in   double   curly-braces 
<"<<.",  ">>")  status  bbn 

bbn  will  be  dead  for  s.n  unknown  period  due 
to. ..[ted. 33  *  hos  CCoutput  of  this  command  has  been  truncat- 
ed   on  ri'iht  end  shortened. JJ 


accat-tip 
aim 
a  r  g  o  n  n  e  ' 
bbn- ten ex b 
bbnd 
ccn 
cmu-1 Od 
dms 
gunter-e I f 
i4-t  enex 
i  si  c ' 
Ibl" 

ll-asg 
london-t  i  p* 

mi  t-ai ' 
mitre-tip" 

m  u  1 1  i  c  s  ' 
n  c  c  - 1  i  p  " 

nors  ar-t i  p' 
nsrdc" 

ns^c-d I ' 
o  t  -  i  t  s  " 

pare ' 
rand-t  ip" 

rutgers-10' 
sdl" 

sri ' 
su-ai  * 

su-t  i  p' 
uc la-secur  i  t y" 
uk-i  c  s ' 
use-tip" 

utah-tip' 
xerox -pare" 


ac  I 

ames-67 

arpo-dms 

bbn-tenexd 

bbne 

cct  c 

cmua 

docb-t  i  v 

gunter-tip 

it l-nts 

i  si  e 

1 1 1 -uni  x' 

mi  t-dms" 

nbs' 

nosc-c  c' 

nts' 

par  c-niaxc' 

sai  l' 

s  r  i-ai ' 

sumex-aim' 

us  c-i  s  i ' 

ut exas " 


afwl" 

ames-tip" 

arpa-t  ip" 

bbn-tenexe" 

bnl" 

cincpac-t  if." 

cmutj" 

e  g  I  i  n  " 

gw  c-t  ip" 

insecurity" 

ka 

I on-eps-qat e 

mit-multics' 

nbs-10' 

nosc-sdl ' 

nyu 

pentagon-t  ip' 

satnet 

s  r i-ka' 

ucl a-ats' 

usc-i  s  i  c' 

wpaf b' 


31 

an  I " 

as  I  " 

bbn-t  e  st  i  p * 

c  ca  " 

cmu-1  Oa  " 

cmud" 

e  t  a  c  " 

harv-1fT 

i  si  " 

kl 

london 

m  i t -t  i  p 

nbs -t  ip 

n  r  I 

of f i ce-1 

radc -t  ip 

scrl-rsx 

sr  i -k I 

uc la -c  en 

us  c-i  s  i  e 

wpafb-afal 


110  alive  (7*j  distinct)  /  ^6  dead  (74  distinct) 
:  now  to  try  a  tew  things  that  are    prohibited/  and   watch   the 
resu It s . 

-  set 

Unknown  set  command  parameter 
send 

No  open  connection  tor  sendino 

"  ec 

Command  requires  a  prefix 
d  i  sp 

Character  m  a  p  p i  n  n  not  implemented 
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qu  '/.    con 
Unix  user  telnet  --  Version  4.0  (11.37) 

t  v  n  e  x 
*  con  s  r  i  -k  I 

Attempting  connection  to  sri-kl 
Connection  open  (char mode) 


SRI-KL,  T0PS-2')  Monitor  101PU14) 

System  shutdown  scheduled  for  Thu 

Up  again  at  Fri  1U-Mar-7fi  04:00:00 

There  are  81+7  jobs  and  the  load  av.  is 

?   ^attach  nobody   ?   apasswd 

?   of  *  e  s  c  a  ►  e  : 

Escape  character  is  : 

Thu  9-Nar-78  13:50:45 

82+7  Jobs    Load  av    7.49   13.96   16.04 


9-Mar-78  23:00:00/ 

8.03  Satt^ch  (user) 


sys 

[};>    14:14:4  5 
7.49   13.96 


System  shutdown  scheduled  for  Thu 
Up  again  at  Fri  10-Mar-78  04:00:00 


9-Mar-78  23:00:00, 


Job 
3 


6 
7 
13 
14 
15 
16 
17 
18 
19 
20 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 


Li  ne 

Oet 

Det 

123 

64 

Det 

114 

142 

232 

57 

62 

35 

10 

•4 

122 

1  74 

5 

173 

Det 

107 

162 

230 

145 

121 

Det 

37 

Det 

12 

66 

125 
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Pr oeram 
RSSER 
DC -4/1 
SOS 
EXEC 
0JKLAV 
LIS3 
EXEC 
LISP 
M  A  C  L  S  P 
EXEC 
TVEDIT 
EXEC 
EXEC 
EXEC 
MSG 

TVEDIT 
TVEDIT 
NLS 
EXEC 
LISP 
NLS 
MSG 
COST 
FTP 
EXEC 
EXEC 
EXEC 
EXEC 
EXEC 
EXEC 


Use  r 
Dev-rsexec 
Dc-203 
Be  rson 
Gut  hciry 

S  locum 

Ga  rvey 

Appel t 

E  I  s  p  a  s 

Moriconi 

Hcbbs 

Hendr i  x 

Agin 

f;o  login 

tfai  r 

Kode  I 

N  i  I  sson 

L  i  ebe  r  iran 

Sei  tz 

We  ins  t  oc  k 

Feedback 

Jones 

Stroke 

H  y  s  m  i  t  h 

G  r  o  s  z 

Thayer 

Klh 

A  i  in 

Robinson 

Hi  1 1  house 


Foreion  host 


(SU-AI) 


( ARC-RD) 
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59 

40 

41 

42 

43 

44 

45 

46 

47 

4  8 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 

60 

61 

62 

63 

64 

65 

66 

67 

68 

69 

70 

71 

72 

73 

74 

75 

76 

77 

78 

79 

80 

81* 

82 

83 

84 

85 

86 

88 

89 

91 


43 

115 

105 

3 

76 
151 

71 
165 
Det 
116 
160 

53 

240 

146 

7 

72 

51 
167 
144 

70 
100 
Det 
234 
156 
Det 
231 

22 
Det 
Det 
111 
Det 
164 
Det 

21 

45 
Det 
242 

61 

15 
120 
170 
235 
237 
236 
6 
Det 

40 

117 

241 

2 

102 


EXEC 

LISP 

EXEC 

TVEDIT 

BSYS 

EXEC 

NLS 

TV 

DIAHLO 

EXEC 

EXLC 

LISP 

EXEC 

DIABLO 

MM 

fc  XEC 

TVEDIT 

EXEC 

SAIL 

EXEC 

EXEC 

EXEC 

EXEC 

LISP 

EXEC 

ft  L  S 

rxtc 

V  T  K  S  E  R 

EXEC 

TECO 

EXEC 

TVEDIT 

TEST 

SNDMSG 

EXEC 

PRVPRC 

FTPSER 

EXEC 

EXtC 

EXEC 

EXEC 

FTTSER 

EXLC 

EXEC 

LISP 

COST 

EXEC 

E  XEC 

D  U  ti  G  E  0 

rxhc 

LISP 


M  e  I  I  i  n  •-? 

Wo  1 1 

Sagalowicz 

Untu  I  i  s 

Seitz 

Green 

He  ck  e  I 

Lamport 

duthary 

Katemopoulos 

W  i  1 1  i  e  rr  s 

Kono I i  ge 

No  I o q i  n 

L  a  m  p  o  r  t 

Mm  cm 

Hoppc  r 

M  e  1 1  i  6  r  -  s  m  i  t  h 

Sacerdcti 

Quam 

Lrobinson 

Barret  t 

B  lean 

Vannouhuys 

W  i  I  b  e  r 

Blean 

P  o  n  g  i  o 

Adrian 

No  I  o (i i  n 

J  rob  i  nson 

Novak 

Th  aye  r 

N  e  -u  ni  a  n  n 

Hedr  i  c  k 

Torres 

Walker 

Landes 

Hedr  i  c  k 

Bo  I les 

Gene 

•lathis 

Diane 

Out  j  ourna  I 

No  login 

No  I  O'l  i  n 

Gas  c  hni  g 

St  roke 

M  c  g  h  i  e 

Roy 

M  e  r  a  d  c  o  m 

He  at  hm an 

Pease 


(RUTGERS- 10) 


(ARC-RD) 


(ARC-RD) 


(RUTGERS-1  0) 


(  0  F  F  I  C  E  -  1  ) 
(  ILL- UNIX) 
(USC-T1P) 


(HELV0IR) 
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92 
93 
9A 
95 
96 
9/ 
98 

1 
2 
8 

9 
10 
11 
12 


233 
Det 
245 

11 
Det 

52 
243 

202 
2  03 
2C5 

2  06 
Det 

210 


exec 

EXEC 

MS 

EXEC 

EXEC 

EXEC 

EXEC 

PTYCON 

D  A  E  -1 0  N 
BATCOM 
LPTSPL 
BSYSPL 
C  F. « [J  F  R 


(NOSC-SDL) 
(USC-JSIB) 

(SU-A1) 


211   FUSS 


Nelc 
Norton 
l.'e  t  info 
G  leason 
Agin 
DolUs 
Ho    loqin 

Operator 
Operator 
Operator 
Operator 
Operat  or 
Ope  rat  or 
Ope  rat  or  a : c  lose 


Connection  Closed 
Linemode 
:  es  c  + 

Escape  character  is  + 

+  e  I  i  n 

Endline  character  is  ' 

+  bye  %  con 

Unix  user  telnet  —  Version  4.0  (11. 37) 

con  ill-nts  -s  23 
Attempting  connection  tc  ill-nts 
Connection  open  (line mode) 

N'o  resources. 
Connection  aborted 

Unable  to  transmit  last  2  characters 

con  i I l-nt  s 
Attempting  connection  to  ill-nts 
Connection  open  (  I i nemode ) 

»>  ENFE  Server  Telnet  <<< 

New  Protocol 

Digital  Technology  Unix  Loo in:  j  s g  Password 

/mnt / j  sq  X 

V.    "esc 
Tscape  character  is  "  "con 
Connection  still  open 


X:    commands  art  repeated  twice  because  both  sites  are  echoinc 
esc  +  esc  +  esc:  not  found  V,    "esc  + 
Escape  character  is  ♦  +con  ill-nts  - s  3 
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Connection  still  open 


%  cat  ma  i  I 
% :  not  e 
pathname/ 
same  name. 
A 1 1  empt  in 
C  onnect  io 
Enter  Mail 
we'll  look 
t  i  ons  ope 
child  that 
net  to  i 
can  be  con 
in  the  cas 
*cl 


box  '/.    '/%'.    no  mail/  let's  make  some  with  telnet  and 
the   one   conn   max/  so  have  tc  re  invoke  telnet  by 
'/. :  because  the  telnet  and  shell  con  commands   have 

%  +/usr/ bin/con  i 1 1 - n  t  s  - s  3 
j  connection  to  ill-nts 
n  open  (linemode)  30C  N F E  Unix  Server 
/  end  by  a  line  with  only  '.'  this  is 

at  in  a  minute.   note  that  there  are 
n   to   ill-nts/  the  original  telnet  connection/  and 

telnet  forked  off  (/usr/bin/con)  which  is  another 
ll-nts   to  the  normal  ftp  server  socket.   this  exer 
fusing,   c hang  inn  the  escape  character   is   recomme 
e  of  mere  than  one  connection  open.   256  Mail  Oeliv 


FTP  mail  jsg 
fake  n  e  t  rn  <j  i  I 
no*/   two   con 


ftp. 
f'ul  I 

the 
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that 
n  f  ■  c  - 

the 
tel- 
c  i  s  e 
n  d  e  d 
e  re  d 


Connection  Closed 

:  still  in  the  sub -telnet.   this  will  net  pissed  to  the 
:  shell  as  it  is  not  a  telnet  command.   the  shell  will 
:  then  ignore  it/  as  the  colon  makes  it  a  comment. 
*  by 
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am  i  jso  ttyX  har  9  01:17  %  cat  mailbox  cat 
Network  Mail  from  host  host-?39  on  Thu  Mar  9 
this  is  fake  netmoil  that  we'll  look  at  in  a 
that  there  are  now  tv.o  connections  open  to  ill-nts/ 
e  I  n  e  t  connection/  and  the  child  that  telnet  forked 
cor.)  which  is  another  telnet  to  ill-nts  to  the  nor- 

socket .  this  exercise  can  be  confusing.  changing 
aracter  is  recommended  in  the  case  of  more  than  one 
n.   %  cat  /dev/null> mailbox  cat  /dev/nu  I  I  >m,.  i  I  box  % 

laying  around??  :  why  leave  it  laying  around??  X 
occurs  because  the  server  at  ill-nts  is  half  du- 
e  pc  ho  occurs  because  the  server  at  ill-nts  is  h;Uf 

OS 


Connect  ion  Closed 
+  con  - h  J 114 
Attemptin  ;  connection 
Connection  open  (linemode) 

>>>  ENFE  Server  Telnet  <<< 
New  Protocol 


Digital  Technology  Unix  Login:  +disc 
Connection  Closed 
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+  con  -h  01 14  -t  1 
Attempting  connection 
Connection  open  (linemode) 

>>>  ENFE  Server  Telnet  <<< 
New  Protocol 

Digital  Technology  Unix  Loo  in:  +:  too  bad*  thought  the  small  con- 
nection timeout  would  blow 

+  +:  the  connection  before  it  got  going.  the  net  must  be  busier 
to 

+  +:  prevent  that  from  happening. 

+  +:  thats  all  fnr  now 

+  +cl 


Connection  Closed 
+  bye 
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3   User  Telnet  Maintenence  Guide 

Up  to  this  point  the  description  of  the  telnet  pronram(s) 
has  been  fairly  general  an 'J  not  re  oily  told  of  the  implementation 
details.   ;>om  we  address  those  details. 

3.1   Principles  of  Operation 

As  stated  earlier/  user  telnet  is  primarily  a  character 
shuffler.  The  available  terminal  modes  for  user  telnet 
(  I  i  n  e  m  o  d  e  /•  charm ode/  m  s  g  m  o  d  e  )  dictate  how  this  shuffling  is  done. 
Lin  em  ode/  as  the  name  implies/  is  a  line-  a  t-a  -time  mode;  charac- 
ters are  buffered  by  the  system  and  given  to  user  telnet  when  the 
user  types  a  line  terminator.  Char mode  does  character- wise  out- 
put to  the  net/  collecting  and  buffering  characters  from  the  user 
terminal  only  for  as  long  as  it  takes  for  the  last  network  write 
to  complete.  r*'sgmode  (message  mode)  is  a  cross  between  the  two: 
buffering  characters  one  at  a  time/  but  sending  them  only  when 
the  (user-settable)  telnet  endline  character  is  typed. 
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C73  There  is  no  reasonable  way/  within  the  standard 
Unix  system  or  the  current  Illinois  Unix/  to  get  around  this 
problem.  Mowever/  the  addition  of  an  enhanced  Inter-Process 
Communication  system  (specifically  events)  would  allow  one 
process  to  wait  for  whichever  system  I/O  operation  completed 
first.  Further  discussion  of  events  may  be  found  in  the 
later  appendix  on  IPC. 


Zhl  Standard  Unix  provides  only  the  sinnul  IPC 
mechanism.  This  mechanism  allows  no  data  to  be  sent  between 
processes/  only  an  indication  that  something  has  occurred, 
further/  there  are  a  reasonably  small  number  ot  signals/ 
which  means  that  you  can  only  transmit  a  very  sm.tll  set  of 
messages  t  hot   something   has   occurred.    Put   the   biggest 


Telnet  Manual 


34 


3.1.1   Process  Structure? 

In  or'.'er  to  allow  complete  full-duplex  interaction/  there 
must  he  two  processes  for  each  telnet  connection.  One  to  read 
from  the  net  arid  write  to  the  terminal/"  the  other  to  read  the 
terminal  and  write  the  net.  This  state  of  affairs  is  caused  by 
Unix  system  calls  blocking  the  calling  process  until  they  com- 
plete -  it  would  be  unacceptable  to  have  the  terminal  unrespon- 
sive when  waiting  for  the  net  I/O  to  complete/  and  vice-versa. 

Towards  this  end/  when  a  user  runs  telnet/  he  is  interacting 
with  the  process  that  reads  from  the  terminal.  Upon  successful 
completion  of  an  open  on  the  network/  this  process  does  a  fork 
and  the  child  exec's  the  companion  process  *hich  will  read  from 
the  net  and  write  to  the  terminal. 

From  this  point  on/  all  of  the  user's  terminal  input  is 
passed  to  the  net  unless  the  line  begins  with  the  escape  charac- 
ter. Jn  this  case/  telnet  attempts  to  interpret  the  command  rjnd 
complete  the  requested  action.  If  the  command  is  ambiouous/  no 
action  (save  an  error  message)  occurs  -  on  the  other  hand/  if  the 
command  is  simply  unknown/  telnet  will  oo  the  fork/exec  sequence 
to  hand  the  command  to  a  shell  (using  the  shell  *-c'  switch)  tor 
execution.  As  an  added  convience/  a  Line  beoinnino  with  an  es- 
cape character/  but  having  no  command  on  it/  will  cause  telnet  to 
fork/pxec  a  shell  for  the  user  to  control  from  the  terminal. 

This  fcrk/exec  sequence  is  normally  done  by  a  routine  which 
takes  pains  to  leave  the  connection  features  unaltered.  Before 
the  fork/exec  is  done/  the  terminal  mode  bits  are  reset  to  what 
they  were  when  the  user  entered  telnet/  and  telnet  is  suspend- 
edC93  until  the  child  process  has  died.  Then  this  routint  resets 
the  terminal  modes  to  their  state  just  prior  to  executing  the 
command/and  proceeds  (see  the  description  of  the  'execute'  rou- 
tine )  - 


trouble  with  signals  is  the  unfortunate  fact  that  a  system 
l/o  call  will  be  aborted/  with  it's  fate  unknown/  when  a 
process  is  sent  a  signal. 


C  <0  This  suspension  is  done  via  a  w?it  system  call/  the 
terminal  resetting  is  accomplished  vio  a  stty  system  c<jLI 
(having  done  a  gtty  system  call  and  saved  it's  results  when 
telnet  is  first  entered). 
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This  procedure  for  executing  auxiliary  pro  g  rams  (next  sec- 
tion) and  Unix  commands  can  have  interesting  and  con  fusing  (for 
the  beginner)  el  feet s  in  some  cases.  For  exam pier  no  matter  how 
hard  you  try  to  reset  the  ter-ninal  modes  via  the  stty  command  it 
just  won't  appear  to  be  working.  In  actuality/  the  requested 
Change  is  indeed  oeing  performed/  and  then  promptly  stepped  on 
when  the  child  dies.  It  is  also  worth  mentioning  that  thp  com- 
panion process  to  handle  the  other  side  of  the  full  duplex  con- 
nection is  not  executed  by  this  routine.  If  it  were/  the  parent 
would  wait  for  it  to  die  before  accepting  input  from  the  terminal 
to  pass  to  the  net. 

3.1.2  Auxiliary  Programs 

Some  of  the  telnet  commands  will/  in  turn/  cause  other  sub- 
sidiary programs  to  be  executed  via  this  fork/exec  sequence. 
Among  such  functions  are  the  "hosts'  command  (executing  hosts)/ 
the  'help'  command  (help)/  and  the  'status*  command  (either  hosts 
or    net  st  at )  C 1  21 .  Of    course/     the     companion     process 

( /et c/us rt e Inet i n )  is  executed  whenever  a  connection  is  opened/ 
but  being  the  result  of  a  rather  special  command/  it  is  treated 
in  a  different  manner  upon  execution  (see  the  description  of  rou- 
tine 'netopen').  In  the  horrible  event  that  any  of  these  pro- 
grams have  vanished  or  the  system  is  out  of  processes/  an  error 
message  is  produced. 

3.1.3  T  e.r  m  i  n  a  I  Modes  and  Character  Buffering 

As  stated  several  times  before/  user  telnet  will  allow  use 
of  one  of  several  terminal  modes.  Basically/  these  nodes  control 
either  echoing/  or  how  the  characters  the  user  types  on  the  ter- 
minal are  handled.  Echo  control  is  quite  simple;  the  user  may 
tell  telnet  to  turn  the  local  echo  on  or  off/  regardless  of  the 
state  of  the  server  on  the  other  end.  Character  handling  mor:es 
are  more  Complex  because  there  are  more  to  chose  from/  and  their 
effects  arc  more  widespread. 

Telnet  allows  three  character  handling  modes:  line  mode/ 
m s q m o d e >  and  char mode.  Linemode  is  implemented  as  Unix  cooked 
mode  -  utilizing  the  system -level  editing  provisions;  char mode 
and  msgmode  are  implemented  via  Unix  raw  mode  and  differ  only  in 
when  data  is  sent  to  the  net.  For  charmode/  each  character  is 
sent  as  soon  as  it  is  received  by  user  telnet/"  msgmode  waits  for 
a  user-settaale  end  line  character  (see  the  "eline'  command 
description)   to   be   typed  before  transmitting  characters  to  the 


f  1 0 3  The    lr-'P/interface    status    program    specified 
(netstat)  may  vary  from  installation  to  installation. 
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nel. 

When  in  line  m  ode^  the  system  buffers  up  input  characters  un- 
til a  (system -de fined)  line  terminator  is  typed.  User  telnet  is 
then  nwakened  and  given  the  buffer  full  of  characters.  For  the 
modes  that  use  Unix  raw  mode/  telnet  reads  characters  as  they  are 
typed*  and  then  buffers  them  until  they  are  transmitted  to  the 
net.  When  a  user-settatle  escape  character  (see  the  'escai.  e  ' 
command  description)  is  the  first  character  on  a  line*  the  entire 
line  is  buffered  by  telnet  (regardless  ol  the  mode)  and  then  in- 
terpreted as  a  command. 

3.1. A   Character  Mapping  Facility 
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The  user  may  also  request  that  a  character  map  set  be  loaned 
via  the  load  c  o  mm  and*  which  takes*  as  an  optional  argument*  a 
pathname  of  the  file  to  load.  There  is  no  checking  of  any  form 
on  the  filename*  so  it  is  possible  for  one  to  load  any  file.  If 
one  does  .not  load  a  tile  produced  by  mkcharmap*  however*  very 
unusual  things  may  transpire. 

3.1.5   Telnet  Option  Negotiation 

Currently*  one  may  send  negotiated  telnet  options  to  an  open 
connection  only  via  the  'send'  command.  This  requires  that  one 
know  the  numeric  value  (octal  or  decimal)  of  the  correct  protocol 
string  for  the  desired  action.  Ag.iin*  this  facility  has  not  been 
expanded  due  to  unsatisfactory  IPC  facilities  on  Unix. 


[113  The  mkcharmap  program  leads  the  user  thru  the 
steps  for  creating  a  character  map  set.  It  lacks  several 
features  that  nay  be  deemed  desirable*  and  c.iuses  some 
trouble  for  the  buffering  scheme  (with  regards  to  echoing). 
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As  the  code  now  stands/  it  is  possible  to  set  up  options  be- 
fore a  connection  is  opened  that  trlri"t  will  negotiate  when  a 
connection  is  first  opened.  In  general'/  these  requests  may  only 
come  from  the  program  logic/  as  the  command  table  lacks  the  key- 
words specify  in. j  the  various  options.  The  hooks  are  in  the  code 
to  completely  do  negotiation,  but  (yet  aiain)  the  Unix  IPC  prob- 
lems prevent  reasonable  i  »r»p  lernent  at  i  on  .  Refer  to  the  'negotiate' 
routine/  .ind  th*.j  sections  on  IPC  and  possible  enhancements  for 
more  discussion  of  option  negotiations. 

3.2   Major  Data  Structures 

Most  of  the  data  structures  of  user  telnet  are  C  structs  or 
constants.  Tor  the  constants/  please  refer  to  the  parameter 
files  cited  above  (usrtelnet.h/  telnet. h/  net  op en. h)  and  assorted 
others  that  are  definitively  listed  in  the  source  of  user  telnet; 
structures  will  be  sketcheo  here. 

3.2.1   Command  Table  Structure 
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3.2.2   The  Openparams  Structure 


To  make  opening  the  net  easier/  a  standard  structure  for 
specifying  network  open  parameters  is  available  (see  netopen.h). 
The  various  exotic  things  that  this  struct  can  be  used  for  .ire 
not  included  in  the  scope  of  this  document/  but  a  few  will  be 
mentioned.  The  o_fskt  field  specifies  the  socket  to  which  the 
connection   will  be  made.   This  is  1  (one)  by  default/  and  should 


Telnet  M a n  u  a  t 


3« 


be  changed  only  in  cuses  like:  the  well  known  server  telnet  sock- 
et ch^nqes  across  the  net.  The  default  nunher  of  seconds  that 
user  telnet  will  wait  before  deciding  that  a  connection  has  not 
been  accepted  is  set  by  the  o_timeo  field.  If  the  connection  has 
not  been  completed  by  that  amount  of  t  i  m  e  •  the  NCP  returns  an  er- 
ror i  ndi  cat  i  on  . 

Four  of  the  fields  in  the  openparam  struct  nay  be  set  as 
parameters  to  the  'connect'  command.  These  are:  the  number  of 
seconds  before  a  connection  attempt  times  out/  the  foriegn  socket 
that  a  connection  will  be  attempted  to  (included  for  experiment- 
in]  with  new  telnets/  establishing  a  connection  to  an  ftp/  etc.)/ 
the  nominal  message  allocation/  which  is  not  particularly  useful 
for  telnet/  and  the  host  number  which  may  be  specified  when  the 
name  of  a  host  is  unknown  but  the  number  is  handy. 

3.2.3   Character  buffering  and  Mapping 
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3.3   Major  Modules 

This  section  and  the  next  contains  all  the  modules  that  ex- 
ist in  usrtelnets  and  brief  descriptions  of  how  they  work  to  aid 
in  understanding  the  program.  This  list  is  brief  in  order  to 
give  an  impression  of  the  general  module  interactions  without 
obfuscation  by  messy  details/'  see  the  code  for  really  up  to  (J ate 
information.  The  modules  are  not  arranged  as  they  appear  in  the 
code  (for  the  i^ost  part);  this  is  an  attempt  to  put  them  in  a 
hierarchical  order. 

3.3.1   usrtelnet  (main) 

The  main  prooram  of  telnet  provides  necessary  initializa- 
tions/- and  then  loops  around  deciding  what  to  do  with  characters 
the  user  types.  If  (s)he  types  a  telnet  commands  the  command 
processor  is  invoked  as  the  Dispatcher.  Of  course/-  when  no  net 
connection  is  open  every  line  is  interpreted  as  a  command;  with  a 
connection  open  only  those  line  beginning  with  the  escape  charac- 
ter are  treated  as  commands.  'ote  that  initialization  could  in- 
clude initiating  a  connection/  with  the  arguments  on  a  command 
line  interpreted  as  it  a  telnet  connect  command  had  been  typed. 

3.3-2   command_processor 

Acting  3s  the  command  dispatcher/  this  routine  gets  an  input 
token  •  (via  g  e  t  o  k  e  n )  and  scans  the  command  table  tor  a  match  with 
a  command  name.  When  no. token  is  present  and  the  net  is  open  a 
shell  is  forked  off  and  telnet  waits  for  it  to  die.  Otherwise^ 
module  getcomm  is  called  to  scan  the  command  tab  le  for  a  match 
between  the  token  and  a  known  keyword.  If  the  token  is  ambiguous 
no  action  is  taken.  If  no  match  was  found  in  the  command  tables 
module  execute  is  called  to  hand  the  line  to  a  shell  for  execu- 
tion as  an  unknown  command [ 1  2D  - 

3.3.3   get  comm 

Module  net  comm  serves  as  t  ti  e  primary  interface  to  the  com- 
mand table.  'when  given  a  token  it  scans  the  entire  command 
table C13D  for  a  match  with  the  token.   Module  com par  is   used   to 


C12D  ..'ote  that  any  Unix  command  may  be  typed  directly 
to  telnet  a no  executed  in  this  manner.  .It  a  restricted 
version  of  telnet  is  desired/  this  is  the  place  to  modify 
the  code.  An  arror  message  may  be  generated  instead  of 
attempting  to  execute  the  command/  and  no  shell  would  be 
executed  on  a  tokenless  line. 


C 1 3  D  The  son  is  (lone  linearlv,  since  the  command  table 
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evaluate  whether  or  not  the  token  mate  ties  a  command  table  entry. 
Note  that  exact  matches  take  precedence  over  partial  matches  in 
order  to  resolve  the  ambiquity  between  -command  pairs  like  *ec' 
and  "echo*.  If/  during  the  scan/  a  match  of  n  characters  is 
found  when  there  ^as  a  previous  match  of  n  characters/  the  token 
is  considered  ambiguous  «j  n  d  a  dummy  command  table  pointer  is  re- 
turned (address  ot  the  last  entry  in  the  c  o  m  m  rt  n  d  t  a  o  I  e  )  /  while 
zero  is  returned  for  no  mate  ties  found. 

3. 3. A   get  oken 

This  module  parses  a  token  from  a  character  string  and  re- 
turns a  pointer  to  its  start.  If  the  passed  pointer  is  zero/  the 
starting  point  of  the  scon  is  found  from  the  global  'nextoken' 
which  is  also  set  in  this  routine.  Blanks  and  tabs  are  scanned 
off/  then  scanning  continues  until  a  break  character  (a  char  in 
the  external  array  "breaks')  is  encountered.  If  there  was  a  to- 
ken present/  it  is  null  terminated  and  a  pointer  to  its  start  re- 
turned.  Otherwise/  a  zero  is  returned. 

3-3-5   get  inpc 


acte 
the 
dard 
by  I 
t  ran 
the 
non- 
char 
the 
we  r 
f  e  re 
ther 
done 
cr-l 
ism 


AS 

r  a 
i  nst 
On 
he  a 
slat 
char 
zero 
acte 
poi 
etur 
d  i 
e  ar 

f  fo 
ade 


the  n 
nd   r 
ruct 
i  x  ve 

_J  -J   •  A.       * 

OU  I  I   1 

ion 
act  er 
/  it 
r /  an 
nte  r 
n  a  c 
n  the 
e  non 
In  o 
r  tel 
into 


a  (.-  e 
etur 
st  ru 
rs  i  o 
on 
of 

at 

i  s 

d  th 

i  nc  r 

har  a 

str 
e  I  e 
rder 
net/ 
a  ca 


i  m  p  I  i 
ns  i 
cture 
n  six 
of  t 
a  g  i  v 
the  m 
a  s 
e  nex 
e  merit 
c  te  r 
uctur 
ft/  i 
to 
if  t 
r  r  i  a  g 


e  s/  t  h 
t  to  c 
/  w  h  i  c 

get  c 
tie   ch 
en  cha 
appi  ng 
igna  I 
t  char 
ed)  . 
that  w 
e  (in 
n  whi  c 
h  a  v  e  t 
he  cha 
e  retu 


is  r 
a  lie 
h  is 
st  ru 
a  r  a  c 
r  a  ct 

poi 
that 

i  n 
See 
as  r 
i  nst 
h  ca 
he  U 
ract 
rnC1 


out  i 
r  . 

s  im 
ct  ur 
ier 
e  r  i 
nt  er 

we ' 
the 
also 
ead 
ruct 
se  a 
nix 
er  t 
A3  i 


ne  g 
Te  mi 
i  lar 
e . 

map 
nto 

(in 
re  i 
map 

m  a  p 
■from 
.dat 

r  ea 
newl 
o  be 
f  te 


ets  t 
i  na  I 

in  t 
The  m 
ping 
an  ar 
st  rue 
n  the 
st  r  i  n 
_e  cho 

the 
an  t 
d  fro 
i  ne  c 

retu 
Inet 


he  n 
buff 
tic  or 
att  e 

f  ac 
b  i  t  r 
t  -de 

mid 
■i  i  s 
/  be 

ter 
o  b  e 
m  t 
fiora 
rned 
i  s    i 


ex  t 
c-rin 
y  to 
r  is 
i  lit 
ary 
f_ex 
d  .  e 

re 
low  . 
mi  na 

p  re 
he 
c  t  e  r 

i  s 
n  li 


i  nput 
g  i  s  do 
the 

c  o  m  p  I  i 
y  v «  *.  l 
string) 
pan_s  tr 
of  mapp 
turned 

Other 
I   and 
c  i  s  e  )  u 
term i  na 

come  o 
a  ne w  I  i 
n  e  m  o  6  e  C 


c  h  a  r  - 

ne  in 
s  t  a  n  - 
ca  ted 
Gw  in  g 
.  If 
)  i  s 
i  n  g  a 

(and 
w  i  s  e  / 

buf - 
n  les  s 
I  i  s 
ut  as 
ne  i  t 
153. 


is  not  outstandingly  lurge.  A  binary  chop  may  be  used  if 
many  more  commands  are  ad  (Jed/  with  minor  modification  to  the 
com  par  routine. 

C143  Note  that  this  is  not  done  for  the  mapped  strings. 
They  are  considered  to  be  literal. 


C153  This  should  not  be  only  line mode/  becaus"  the  Unix 
newline  translations  also  depend  on  the  setting  of  the  stty 
nl  translation  bit. 
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3.3.6   buffer. full. line 

This  routine  simply  gathers  up  characters   in   the   external 
character   array  net  but  until  an  end  line  character  is  seen.   Also 


provided  here  are  the 
tire  partial  line  and 
if  the  character  is  a 
telnet   will   exit, 
returned. 


line  editing  provisions  of  erasino  the  en- 
erasing  the  last  character  saved.  further* 
DELETE  or  EOT  and  no  connection  is  open/ 
The  number  of  characters  saved  in  netbuf  is 
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3.3.8   netopen 

Net op en  opens  a  network  connection.  It  has  no  parameters 
and  gets  any  information  needed  from  global  datu  (such  os  net- 
buf). Since  multiple  concurrent  connections  are  not  allowed  in 
this  version*  netopen  will  return  if  called  with  a  connection  al- 
ready open.  It  first  parses  the  hostname/  if  present/  out  of 
netbuf  via  ge token  and  constructs  the  special  file  name  ncces- 
saryC163.  .\'ext/  it  calls  rr.odule  I oadopnpa rams  which  parses  off 
the  rest  ot  the  command  line  and  stores  the  appropriate  data  in 
the   (glob.il)   openparams    srtucture.     In    the    event    that 


C 1 63  If  no  hostname  is  present/  *  any host'  is   used   and 
th"""   host   number   is   expected   to   be 
structure 
are  parsed 


If  no  hostname  is  present/  *anyhost"  is  used   and 

number   is   expected   to   be   in   the  openparams 

when  the  open  is  done.   This  and  other  parameters 
I  and  loaded  by  nodule  I  o adopnp a r am s  . 
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3.3.9   loadopnparams 

Here  we  parse  off  the  extra  parameters  to  the  connect  com- 
mand and  load  them  into  the  (global)  openparams  structure.  The 
structure  is  zeroed  to  remove  any  old  data  and  any  telnet  default 
values  (such  as  the  timeout  of  120  seconds)  are  initialized. 
Starting  at  tire  cussed  character  pointer/  the  strinq  is  scanned 
for  parameters  which  are  loaded  into  the  structure  as  they  are 
encountered;  the  scan  terminates  when  there  are  no  tokens  remain - 
inn  in  the  parameter  strinc.  If  an  unrecognized  parameter  is  en- 
countered/ the  scan  is  aborted  and  the  routine  returns  to  the 
caller  with  an  error  indication, 

3-3.10   netclose 


3.3.11   option 

This  routine  is  used  to  cc-rry  on  the  telnet  option   negotia- 
tions.   A  caveat  is  immediately  needed:  due  to  the  lack  of  reli- 


[173  The  value  of  save mode  is  set  by  the  set_*moue 
routines  (such  as  set^lienmodo/  etc.)  and  has  no  effect 
until  a  connection  is  opened.  That  is/  the  actual  mode  is 
not  altered  until  a  connection  is  opened/  but  remembered  in 
save  m ode. 
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able  communication  between  the  parent  and  child  processes/  the 
range  of  the  options  negotiation  that  may  be  implemented  reason- 
ably is  very  limit edL1 83.  At  :nost/  the  intentions  of  n.oaule  op- 
tion can  be  described.  n r i e 1 1 y /  there  ore  tour  static  bit  m * p s 
which  describe  the  option  status;  the  mops  are  kept  in  i  n  t  s  / 
which  restricts  the  number  of  suf portable  options  to  sixteen/  but 
Ion  is  would  -ork  just  as  well.  These  status  flags/  an  (J  what  they 
represent  are: 

opt  in  effect     bits  set  for  each  option  in  effect  current- 

l  y 

op t_re quested     marks  those  that  hove  been  requested  of  the 

other  side/  but  not  yet  replied  to 


opt_iir.plemented 


marks  those  options  that  telnet 
sider  ana  con  support 


will   con  - 


opt_desi  red 


is  a  place  to  rememoer  settings  requested 
whil^  the  connection  was  closed  that  should 
be  negotiated  upon  opening. a  connection. 


In  addition/  there  are  three  additional  maps  with  which   to   keep 

track  of  the  status  of  the  foreian  host  uhich  have  the  sa:ne  names 

with  an  *f*  prependeo  ( op t_ imp I  em en ted  is   omitted)   which   are 
currently  not  used. 

The  routine  consists  mainly  of  a  switch  state -nent  to  decide 
what  to  do  with  th e  requested  action  passed  as  a  parameter.  In 
the  interests  of  modularity/  one  of  the  actions  is  OPTINQY  which 
will  return  an  indication  as  to  the  current  status  of  the  passed 
option.  The  static  oit  maps  are  not  made  external/ gluteal  in  on 
attempt  to  make  telnet  a  bit  more  structured.  Similarly/  the  0 P - 
TIN1T  case  does  the  initial  negotiation  for  all  the  options  the 
user  requested  prior  to  opening  a  connection.  It  scons  the  map 
and  outputs  telnet  will  and  do  protocols  for  any  appropriate  op- 
tion. There  is  also  a  case  far  each  of  the  telnet  protocol  mes- 
sages will/  wont/  do  and  dont.  They  formulate  a  response  and 
send  it  to  the  net. 


C 1 8  D  Actually/  there  are  several  schemes  for  doing 
option  negotiation/  but  all  are  rather  cumbersome.  The  main 
trouble  is  the  fact  that  the  standard  Unix  signal  me ch on  ism 
is  hazardous  to  the  life  of  system  calls.  Please  refer  to 
the  later  sections  on  IPC/  options/  etc.  for  further 
di  s  cuss  i  on . 
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3.5.12  s  e  t  _  c  ;n  d 

Module-  set_cmd  is  the  dispatcher  for  all  commands  which  ire 
prefixed  by  the  set  command.  It  is  called  thru  the  command  t  a  b  I  *• 
with  two  p  a  r  a  m  e  t  e  r  s  :  a  word  of  dota  and  a  word  of  flays.  If  data 
is  zero/  it  was  called  due  to  a  set  command  and  must  parse  off 
the  next  token  to  deduce  it's  action.  If  the  next  token  is 
known/  data  and  flags  are  set  from  it's  entries  in  the  command 
table;  if  not/-  they  are  set  to  cause  an  error.  The  flag  word  is 
then  tested  aqainst  the  FPSET  mask  to  determine  if  the  command 
may  be.  prefixed  by  the  set  command/  and  if  not/  a  messacjc  is  gen- 
erated and  error  indicator  returned.  Thus  assured  that  the  data 
is  valid/  we  enter  a  switch  to  cause  the  appropriate  routine  to 
be  called  for  action. 

3.3.13  send  cmd 


Module  send_cmd  is  similar  to  set_cmd/ 
capabilities.   First/  if  a  net  connection  is 
an  error  indication  (no  place  to  sf-nd).    If 
nonzero/   and   greater   then  Q 1  7  7  /  it  is  ass 
command  (such  as  'synch'  or  "ayt")  and   the 
send_proto   for   transmission.   If  the  word 
is  sent  just  as  is.   On  the  other  hand/  if 


this   is   indeed  a  s e n d  command, 


The  send  c 


parsed  off  the  command  line  via  get  ok  en  and 
as  tokens  remain.   It  any  token  is  not  of   c 
error   message   is   generated   and   it   is 
byte(s)  are  then  written  to  the  net. 


but 

not  o 
the 
umed  t 

by  t  e 
is  les 
the  d 
omma nd 
i  n  t  e  r  p 
o  r  r  c  c  t 
ski  ppe 


has   ad 
pen  /  it 

da  t  a 
o  be  a 

is   pa 
s  than 
eta   w  a 

parsme 
reted 

tcrmC 
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ditiona  I 
returns 
word  is 
pro  to  co  I 
s  sed  to 
020C/  it 
s  zero/ 
t  p r  s  are 
as  I  o  n  n 
193/  an 
de  s  i  red 


3. A   Minor  Kodules 

The  term  'minor  modules'  describes  those  routines  which  have 
little  or  no  impact  on  the  flow  of  control  of  user  telnet.  These 
are  used  by  the  m<jjor  modules  and  each  other  (in  some  cases)  to 
prevent  obscuration  of  the  problem  with  messy  details.  Again/ 
they  are  not  presented  in  their  order  of  appearance  in  the  code 
itself  and  have  been  shuffled  in  the  hopes  of  painting  a  semi- 
coherant  picture. 


[19  3  The   forms  allowed  are  in  the  specifications  book/ 
but  briefly  they  are: 

nnn        to  send  a  numerically  specified  byte. 

Interpreted  as  octal  if  the  first  digit  is  a  zero. 
/c        to  send  the  control  character  corresponding  to  character 

The  hi  oh  order  three  bits  >ire  zeroed. 
cmd        a  command  which  may  be  prefixed  by  the  send  command 


Telnet    Manual 


45 


3.4.1  set.echo 

Called  with  two  parameters/  set_echo  sets  the  echo  mode  flarj 
and,.  if  necessary/  calls  chngtty  to  effect  the  stty  system  call. 
The  parameters  are  produced  by  the  c omnia nd  table  and  consist  of 
the  sett inq  desired  and  the  usaie  flags.  In  the  case  of  settinc 
Sf:TECH0/'  the  routine  was  called  by  module  set_cmd/  and  the 
desired  setting  is  parse d  from  the  command  line  and  echo  set  ac- 
cording to  it.  Although  the  option  negotiation  routine  is  not 
currently  notified  of  the  change/  the  proper  call  is  in  the  code/ 
commented  o  u  t  C  2  0  3  . 

3.4.2  set _end line 

H  a  v  i  n  >  no  parameters/  this  routine  sets  telnet's  idea  of  the 
line  termination  character  to  the  first  character  in  the  next  to- 
ken on  the  command  line.  If  no  token  is  present/  no  set  is  done. 
As  usual/  the  token  is  extracted  via  getoken.  The  endline  char- 
acter is  also  added  to  the  list  of  break  characters  (external 
character  array  breaksC3)  that  getoken  uses  in  parsing.  Finally/ 
the  current  setting  of  the  endline  character  is  typed  on  the  ter- 
minal -  this  means  that  if  no  token  was  present/  the  routine 
displays  the  endline  character  instead  of  setting  it. 

3.4.3  set  escchar 


Set_escchar  is  almost  identical  to  set_endline;  the 
ence  being  the  place  the  escape  character  is  stored.  Th 
nal  (character  array)  prmptlD  contains  the  telnet  command 
which  is  r:ade  up  of  seme  pa  dd  in;  with  the  current  escape 
ter  in  the  middle.  Thus/  the  only  place  hit  by  set_esc 
prmptC13/  and  all  references  to  the  escape  character  are 
that  location.  The  prompt/escape  storage  was  aone  in  thi 
to  relieve  any  ambiguity  that  may  have  resulted  from  runn 
nets  withing  telnets  -  this  way/-  if  you've  set  distinct 
characters/  you  always  know  which  telnet  you're  sending  a 
to. 


differ- 

e  exter- 
prompt  / 
chcr-ic- 

c  ha  r  is 
done    on 

s    manner 

i ng  tel- 
es cape 
co  mm  and 


[203  It  seems  reasonable  that   the   following   settings 
should  be  recognized: 


on 
off   / 


>  1  m mediate  control  of  Local  echo  only. 


local     >.-3eqin  option  negotiation  to  set  who  echos. 
remote   / 
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3. A. A   set_tty 

Althojqh  the  name  implies  that  this  routine  is  the  workhorse 
of  the  terminal  mode  setting  business/'  it  has  nothing  to  do  with 
t  h a t  .  Initially  written  <» s  a  d e  t> u y g i  n g  aid/  f>  n  d  included  as  a 
means  of  findinj  out  where  you  are/  this  routine  types  the  telnet 
terminal  mode  fl3qs  and  forks  off  a  child[213  to  execute  stty  (I) 
for  the  system's  idea  of  the  terminal  status. 

3. A. 5   set_charmode 

This  routine  sets  telnet  into  character-at-a-time  mode.  All 
that  it  Joes  is  reset  from  line  mode  (calls  r ese t _ I i nemode )  and 
sets  the  appropriate  flags. 

3.4.6  set_msymode 

Analogous  to  char  mode/  we  reset  from  line  mode  and  set 
flags  appropriately. 

3.4.7  set  tenexmode 


set 


More  of  the  same  type  of  stuff.   This  routine   simply 
charmode  and  set_echo/  and  then  sets  the  proper  flaa. 


calls 


3  .  A  .  3   reset_linenriode 

In  addition  to  flag  setting*  this  routine  sends  a  signal  to 
the  companion  processT22T  to  indicate  the  transition  in  moue  and 
then  invokes  module  chnqtty  to  set  the  terminal  into  raw  mode/ 
et  c . 

3.4.9   set_linemode 

Inverse  of  reset_linemode:  sets  the  flags*  and  sends  a  sig- 
nal to  the  child  (companion  process)  to  indicate  the  mode  chance. 
The  signal  is  not  sent  if  the  companion  is  just  starting/  similar 
to  reset  I  inemode . 


C  2 1  D  This  is  <<01  done  by  module  execute  because  it 
diddles  the  terminal  modes  before  and  after  it  forks.  The 
true  state  of  the  terminal  would  thus  not  be  revealed  unless 
settty  did  a  fork  on  it's  own. 


[223  The  s  i  n  n  a  I  is  NOT  sent  when  the  companion  has  just 
been  started  up.  This  is  determined  by  the  flag  parameter 
and  done  to  avoid  killing  the  child  before  it  can  yet  set  to 
handle  signals  correctly. 
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3. 4. 10   chngtt/ 

Used  to  set  and  reset  the  terminal  mode  bits/  this  routine 
takes  two  integer  arguments  representing  the  mode  bits  to  set  and 
reset/  respectively.  It  then  calls  stt>2  with  the  mode  word 
created  from  the  expected  boolean  functions  of  the  current  mode 
word  and  the  set/reset  masks. 

3. A. 11   stty? 

This  routine  sets  the  mode  word  of  the  terminal  to  its  in- 
teger parameter.  To  avoid  doing  unnecessary  stty  calls/  this 
routine  only  calls  stty  if  the  desired  mode  is  not  the  same  as 
the  current  modeC23J. 


3.4.12  pushtty 

Working  in  conjunction  with  p  o  p  1 1  y  /  this  routine  provides  a 
small  stack  for  remerrbering  terminal  mode  bits  during  temporary 
states  (like  opening  of  net  connections  and  executing  Unix  com- 
mands )  . 
the  top  is  in  the  external  ttystkp 

3.4.13  poptty 


The   stack   resides  in  the  external  array  ttystack/  and 


Inverse  of  module  pushtty. 

3.4.14  ser.d_proto 

Two-byte  telnet  protocol  requests  go  thru  this  routine. 
Taking  the  byte  of  protocol  as  a  parameter/  it  prep ends  the  tel- 
net IAC  byte  and  sends  the  message  off  down  the  net.  If  the  pro- 
tocol- request  is  a  DM  (data  mark)/  the  companion  is  told  to  ex- 
pect an  INS  from  the  other  side  of  the  connection  (vie*  a  signal 
to  it)  'and  the  sendins  routine  is  called  to  accomplish  what  the 
name  says. 

3.4.15  helper 

Acting  as  a  switch  for  the  various  help  functions/  this 
module  takes  care  of  invoking  them  correctly.  Currently/  it  pro- 
vides for  the  help  command  (by  parsing  the  command  line  for  it's 
args/  and  then  executing  the  help  program  via  execute)/  for  the 
hosts  command  (by  passing  the  buck  to  the  hosts  routine)/  for  the 


C233  Current  mode  is  found  in  the  curtty  array/  which 
represents  the  stty  buffer  format  in  a  3  word  array.  This 
makes  the  modes  word  curtty C2]/  and  hence  the  name  stty2. 
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commands  command  (by  listing  the  keywords  from  the  cOfMnanri 
table)/  and  for  the  status  command  (by  usin;:  execute  to  run  the 
netstat  program).  The  various  cases  are  distinguished  by  the 
constants  in  the  command  tabic/  which  the  command  processor  uses 
to  call  this  routine. 

3 . A . 16   execute 

Performs  the  gyrations  to  run  another  program  from  telnet. 
This  is  not  as  bad  as  it  sounds  -  just  push  the  terminal  mode  ..nd 
set  to  the  original  (entry)  mode/  do  a  fork  (and  exec  if  the 
child/  wait  if  the  parent)/  and  pop  the  terminal  modes  to  reset 
them.  Frills  and  complications  include  having  the  parent  ignore 
the  quit  and  interrupt  signals  *hile  waiting/  and  typinn  a  prompt 
to  indicate  the  end  of  the  command's  execution  when  the  wait  call 
comp  letes . 


3. A. 17   bye 

Generally  a  cleanup  routine  in  case  something  qhastly  hap- 
pens. It  closes  the  net  connection  (via  netc  Lose)/  resets  the 
terminal  to  the  mode  it  had  on  entry  to  telnet/  and  calls  exit. 

3. A. 18   hosts 

This  module  fields  requests  for  host  status/  at  a  Lower  lev- 
el than  helper.  It  prepares  to  run  the  hosts  prog r am f  and  then 
has  execute  do  it.  If  the  parameter  is  non-zero/  it  is  assumed 
to  be  a  pointer  to  a  string  which  is  appended  to  the  command  line 
-  that's  how  status  info  v;\    specific  hosts  can  be  obtained. 

3. A. 19   load  char  set 
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3.4.20   delay 

A  means  to  waste  some  time/  delay  invokes  the   sleep   system 
call  with  the  number  of  seconds  as  specified  in  it's  parameter. 


3.4.21   prompt 

Writes  the  command  prompt  on  the  terminal  if  a 

ticn  is  not  open. 


net 


connec  - 


3.4.22 


co-*pa  r 


Used  to  determine  character  string  matching  for  command 
parsina.  Given  pointers  to  two  strings*  corr.par  will  count  how 
well  they  mated  and  return  zero  for  an  exact  match*  and  an  in- 
teger indicating  the  number  of  characters  matched  otherwise.  If 
the  mismatch  occurs  on  the  null  terminating  the  first  string*  the 
number  of  characters  +1  matched  is  returned;  otherwise*  this 
number  negated  is  returned. 

3.4.23  strmove 

Copies  the  string  pointed  to  by  the  first  parameter  to  the 
destination  address  specified  by  the  second  parameter.  The  copy 
ends  after  a  null  is  reached.  Returned  is  the  address  of  the 
null  terminating  the  destination  strina*  so  the  routine  may  be 
called  r  e p c- a t  e d  t  y    to  append  strings  with  a  minimum  of  fuss. 

3.4.24  set member 

Determines*  predicate  style*  if  the  character  specified  by 
the  first  parameter  is  in  the  string  whose  address  is  given  by 
the  second  parameter.  In  ether  words*  if  the  first  parameter 
(character)  is  a  member  of  the  set  represented  by  the  second 
parameter  (pointer  to  a  character  string)*  a  non-zero  (true)  is 
returned.  A  zero  (false)  is  returned  if  the  character  is  not  in 
the  set. 

3.4.25  nun  be  r 

Converts  strings  of  ascii  digits  into  integer /binary  format. 
If  the  number  begins  with  the  character  *0'  it  is  assumed  to  be 
octal*  otherwise  decimal.  Any  non-digit  (or  non-octal  digit  if 
the  number  is  supposed  to  be  octal)  terminates  the  scan.  Addi- 
tionally* if  a  non-octal  diqit  is  found  in  a  supposed  octal 
number  an  error  message  is  typed. 

3.4.2  6   bit  on 


Also  a  predicate.   True  if  the  bit  number   specifed   by   the 
first   parameter  is  set  in  the  bit  string  specified  by  the  second 
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parameter  (which  is  actually  a  pointer  to 
false  otherwise. 


an 


array   of   bytes)/' 


3.4.27  set _b it 

Sets  the  bit  specified  by  number  in  the  first  parameter  in 
the  bit  string  specified  by  the  second  parameter.  See  bit_on  for 
some  details. 

3.4.28  reset_bit 
Inverse  of  set.bit. 

3.4.29  getho.-nedir 

Extracts  the  home  directory  of  the  current  user  from  the 
password  file  (the  password  itself  is  not  used/needed).  Returns 
a  pointer  to  the  string  containing  it  if  successful/-  zero  if  un- 
successful . 

3.4.3U   colon 

Given  a  pointer  to  a  string/  scans  for  the  next  colon  and 
returns  a  pointer  to  the  character  after  it.  Used  by  gethomeoir 
to  parse  the  password  tile. 

3.5   About  the  Companion  Process/'  Usrtclnetin 

In  order  to  achieve  a  full-duplex  connection  under  network 
Unix/  one  process  is  required  for  each  direction.  User  telnet 
provides  communication  between  the  user  and  the  network/  the  com- 
panion provides  communication  between  the  network  and  the  tele- 
printer (screen/  etc.).  As  the  companion  process  need  not  cope 
with  the  user's  requests  (and  cannot  cope  with  the  option  nego- 
tiation/ as  we  shall  see  later)  it  is  rather  simple. 


3.5.1   General  Overview  of  Functioning 


'forever 


The  main  loop  of  the  companion  consibts  only   of   a   trivial 
loop.    For  each  traversal  of  this  loop/  one  character 

character   is 


is    i  nput    f  rom    the 

side 
terpreted    as    a 


outside       of     the    Telnet     Ascii     range     igr 

protocol       commandC24D. 


If   th 


network  and  acted  upon 

range  (greater  than 

The   character 


127. ) r    it  is  in- 
i  s   then 


[243  The  obvious  drawback  to  this  scheme  is  the 
prohibition  of  Telnet's  binary  transmission  option. 
However/-  it  remains  as  a  measure  of  grace  for  the  old  telnet 
prot  oco I . 
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deleted  iron,  the  buffer*  and  the  process  repeated.  Of  course/ 
the  character  is  output  to  the  terminal  if  it  is  in  the  normal 
A s  c  i  i  ranqc*. 

3.5.2   Te I  net /Companion  Communication 

There  are  several  reasons  telnet  may  want  to  direct  the   ac- 
tions of  the  compa-  ■  p    ;■(■,..-«  •;,-..,->, ,,-<,,,  -*■-.;-,   ,- i 


3.5.2-1   SIGINT  and  SI  GO  IT 

These  signals  are  usually  generated  directly  by  the  user 
from  keys  which  have  a  special  'out  of  band*  meanino  to  Unix: 
process  interruption  and  interruption  forcing  a  core  dump/ 
respectively.  Their  semantics  restrict  their  use  to  conditions 
where  the  user  has  requested  that  telnet  abort  operation.  Be- 
cause the  companion  is  viewed  as  a  slave  of  user  telnet  proper/ 
they  are  ignored. 

3.5.2.2  SIGNUP 

This  signal  denotes  the  disappearance  of  the  carrier  on  a 
modem  connection  under  normal  usane.  In  the  current  context  it 
is  viewed  as  a  condition  which  should  cause  termination  of  the 
connection^  a  generalization  of  the  original  usage.  When  user 
telnet  wishes  the  companion  to  die  gracefully  it  s^nds  this  sig- 
nal/ which  the  companion  then  traps  (in  routine  huptrap).  be- 
cause this  is  the  normal  exit  procedure  for  the  companion/  it 
prints  a  brief  message  to  the  user's  terminal  informing  him/her 
of  the  loss  of  the  connection.  fJote  that  if  the  user  terminal  is 
indeed  a  dialup  which  loses  carrier  the  expected  exit  occurs. 

3.5.2.3  SIGINR 

This  sign c I  is  not  present  in  standard  Unix/  and  was  added 
to  support  the  network's  capability  for  out  of  band  signals  on 
the  cor; trot  link.  The  telnet  protocol  uses  this  feature  to  im- 
plement its  synch  sequence.  Cons e quent I y /  receipt  of  this  signal 
causes  counters  and  flags  to  he  set  to  indicate  the  expected  ap- 
pearance of  a  telnet  data  mark  in  the  input  stream. 

3. 5. 2. A   SICPIPE 


This  siqnal  has  no  relevance  to  telnet  and  has  been   pirated 
for  another  purpose  entirely.   When  the  user  requests  a  synch  se- 
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que  nee  sent  telnet  informs  the  companion  to  expect  an  'interrupt' 
from  the  n^t.  The  trapping  routine  (expect_an_ins)  s^ts  flags  to 
indicate  that  this  signal  was  received  -so  the  input  routine  does 
not  qet  confused  about  the  error  return  from  its  reao  of  the  net- 
work . 

3.5.?.$   SJGSPA 

This  signal  is  undefined  in  standard  Unix/  but  allowed  for/ 
and  is  named  as  the  first  'spare'  signal.  The  routine  that  traps 
this  siqnal  tor,cles  a  flaq  which  causes  carriage  returns  to  be 
ignored  or  passed  to  the  user's  terminal/  dependent  on  the  mode 
of  the  local  terminal. 

3.6   Comments  in  Hindsight 

User  telnet  has  several  problems  that  are  not  easily 
corrected.  M o s t  of  these  small  griefs  are  direct  results  of  the 
initial  design  of  proqram  structureC25D  and  subseqent  patches  to 
relieve  the  problem.  Refer  to  the  appendix  req^rdinq  the  need 
for  IPC  for  more  information  on  this  class  of  problem.  Some  of 
the  troubles  are  just  a  result  of  patch  after  patch  over  an  e  x  - 
tened  period  of  tiire  to  increase  the  features  and /or  performance 
of  user  telnet/  the  code  has  become  increasingly  cumbersome  and 
obtuse.  In  general/  this  code  for  user  telnet  provides  a  reason- 
able conceptual  base  for  the  complete  rewrite  which  will  be  need- 
ed to  make  use  of  enhanced  Unix  IPC. 

3.6.1   Bugs  and  Other  Vermin 

There  are  a  few  rouqh  spots  in  user  telnet  that  could  use 
some  attention/  but  they  are  minor  annoyances  and  should  cause  no 
trouble  to  the  casual  user.   Without  delay  then/  a  list: 

Option  negotiation  cannot  be  reasonably  implemented  as 
both  telnet  processes  need  to  be  aware  of  the  state  changes 
of  the  other/  or  request  changes  of  state  based  on  commands 
received  from  the  network  or  user  keyboard.  See  the  appen- 
dix on  telnet  with  IPC  for  possible  solutions. 


be 


While  on  the  topic  of  options  and  protocol/   it   should 
pointed   out  that  this  version  of  telnet  does  not  handle 


C  2  5  3  when  user  telnet  was  first  designed  the  effects  of 
Unix  I/O  calls  blocking  was  discounted.  This  lead  to  the 
split  into  two  processes  to  reasonably  handled  the  duplex 
nature  of  a  telnet  connection/  which  lead  to'  the  problems  of 
each  simplex  process  knowing  what  the  other  was  doing. 
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As  long  as  the  topic  of  connection  modes  is  on  hand/*  a 
suggestion  is  in  order.  There  is  a  separate  routine  to 
switch  to  each  mode  available;  while  this  is  good  program- 
ming practice**  it  forces  switch  statements  to  be  repeated  in 
sever.il  places  in  the  code.  Perhaps  one  routine  (set  _t  mode) 
to  handle  all  transitions  would  make  the  code  a  bit  less 
verbose . 


3.6.2   Possible  Enhancements 

Several  additions  could  be  nade  to  user  telnet  to  increase 
its  usefulness  and  flexibility.  Prnon::  these  are  the  addition  of 
a  switch  to  set  the  terminal  mode  froti;  the  invocation  line* 
and/ or  the  use  of  a  TOPS-10  style  switch  initialization  file  in 
the  user's  home  directory.  These  class  as  conveniences/-  like  the 
tenexmode/  a  no  may  be  safely  ignored.  The  outstanding  enhance- 
ments to  user  telnet  are  unachievable  with  the  current  Unix  sys- 
tem due  to  the  lack  of  reasonable  IPC. 


For  example/  option  negotiation  is  not  carried  out  in  any- 
thing like  a  st  raifjht  f  orward  manner.  In  f^ct/  once  a  network 
connection  is  opened  and  the  companion  process  spawned/  telnet 
proper  does  not  read  from  the  network  at  all.  Thus  the  companion 
must  deal  with  requests  for  option  negotiation  in  the  only  way 
possible  -  stark  refusal  to  change  state.  Of  course/  us  with  oil 
the  world's  ills/  this  too  can  be  remedied  with  IPC  facilities. 
Refer  again  to  the  IPC  appendix. 
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3 .  r*   Installation  of  User  Telnet 

The  steps  required  to  net  user  telnet  ready  to  run  are  out- 
lined in  this  section.  Primarily/  an  explanation  of  the  actions 
of  the  *  R  u  »  i  •  shell  file  kept  in  the  telnet  h  o  in  e  directory  is  p  r  o  - 
vided.  As  an  extra  added  feature/  a  list  of  the  files  needed  to 
accomplish  the  'Run*  tile's  execution  is  also  provided.  All 
references  to  files  that  are  not  full  pathnames  are  taken  from 
the  telnet  home  directory. 

3.7.1   List  of  Files  for  User  Telnet 

This  is  intended  to  serve  as  a  guide/  if  not  a  definitive 
list/  of  the  files  needed  to  maintain  and  run  user  telnet. 
Of  course/  for  exact  treatment  of  how  the  files  aiid  programs 
are  used  and  confiqurer!/  the  Run  shell  file  is  the  best 
resou  rce  for  you . 

Names  for  telnet: 
/usr/ bin /telnet 
/usr/bin/con 

User  telnet  home  directory  (at  Illinois): 
/sys/netsys/ncpp/utel 


Current  version(s): 

user  telnet        4.0  (11.37) 
companion         .4.0  (11.2) 


(usrtelnet.c) 

(usrtelnetin.c) 


Parameter  files  (specif ieo  from  the  user  telnet  home 
di  recto  ry) : [263 

../h/net/usrtelnet  .h 

.  .  /-h  /  n  1 1  /  t  e  I  n  e  t  .  h 

. . / h/param  .h 

. . / h /user,  h 

. ./h/net/mkcrarmap.h 

../h/net/netopen.h 


Accessory  routines  (called  for  some  of  the  commands) 
and  the  files  they  access  : 

/etc/h^sts         (hosts. c  see  next  section) 
/etc/help  (aux/help.c) 

/mnt/help/telnet 
/etc/netstat       (netstat.c  see  next. section) 


C  ?  6  D  include  tiles  to  be  in  /usr/include.    Check 
local  documentation  and  conventions  tor  exact  loction. 


your 
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(several  that  wyn'l  be  enumerated  here/ 
principly  the  files  in  /dev/nel) 

N.  B.  The  choice  of  the  program  to  perform  this  function 
dependent  on    which  ItfP  inter-  face  your  system  has. 


1  s 


3.7.?   The  Run  Shellfile 

This  file  may  be  used  to  bring  up  user  telnet.  Consult  the 
listing  of  the  file.  Note  that  it  takes  an  option  n  I  argument; 
this  is  induced  tor  the  purpose  of  dress  rehearsals.  In  other 
words/-  the  command  'Run  /trap'  will  execute  the  Run  file/  and  act 
as  if  /tmp  were  the  root  of  the  file  system.  Directories  like 
/usr/tin  and  /etc  will  need  to  be  present  in  the  fake  root  in 
order  for  the  command  tile  to  work  correctly. 


this  Run  shell  tile  compiles  all  programs  needed  by  user  telnet 
the  executable  files/  and  any  text  files  are  moved  to  the 
appropriate  directories. 

This  shell  tile  may  be  tested  by  executing  it  with  an  argument. 
This  argument  is  taken  to  be  the  -root-  of  the  filesystem/  and 
all  file  creations  are  done  with  respect  to  it.   see  the  code. 

further  debugging  aid  is  provided  by  usina  the  optional  SECOND 
argument/  which  will  cause  an  experimental  version  to  be 
generated  with  slightly  changed  names  if  it  is  -x   c.  -X-  . 

Files  are    set  to  be  owned  by  user  bin  of  group  bin. 


NOTE  :  since  the  telnet  version  number  is  part  of  the 

name  of  the  source  file/  this  file  must  be  editted 
when  release  of  a  new  version  is  desired. 


must  have  null  or  valid  args 
f  $1 x  =  x  goto  chk2 

else/  need  to  see  if  first  arg  writable 

it  -w  $1  goto  chk2 

:  else/  bad  first  arg/  not  writable 

echo  cant  use  $1  as  the  fs  root. 

exit 
:  chk2 

:  make  sure  the  second  ar;  is  -x-  or  -X-  if  its  there 
ifS2^  =  q   -o   $?q  =  Xq   -o   $2q  =  xq  goto  plowon 

echo  invalid  second  arg  -12- 

exi  t  -1 
:  plow  on 

:  finally  ready  to  start  off  with  the  user  telnet  program  itself 
if  $2q  !=  q  cc  -0  -s  -n  -o  telnet  -D  xtni  usrtelnet.c  -Ij 
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if  %2q    -    u 


cc  -0  -s  -n  -o  telnet  usrtelnet.c  -Ij 


:  done  c  o  ft  p  i  I  i  n  y  *  switch  off  for  the  renaming... 
if  %2 <\    !=  q         goto  Linkxver 

:  make  sure  that  the  links  dont  yet  in  the  ..ay. 

:   -t  switch  to  rm  soys  zao  file  even  if  not  0  222  mode 

rm  - f  $1/usr/bin/con  $1/usr/bin /telnet 

m v  telnet  11/usr/bin 

chmod  555  SI /us  r/bin/ t  e  Inet 

cho.,n  bin  11/usr/bin /telnet 

c  h  g  r  p  bin  S1/usr/bin/telnet 

In  S1/usr/Mn/telnet  $1/usr/b in/con 

goto  usrteldone 
:  link  xve  r 

:  experimental  -  change  names  to  protect  innocent  (user) 

rm  -  f  S1/usr/bin/xcon  S1/usr/bin/xtelnet 

mv  xtelnet  11/usr/bin 

chmod  5  5  5  T.  1/usr/bin/xtelnet 

c  h  o  *  n  bin  >1/usr/bin/xtelnet 

chgrp  bin  i1/usr/bin/ xtelnet 

In  $1/usr/bin/x telnet  S1/usr/bin/xcon 
:  usrteldone 

:  the  auxiliary  programs  and  text  files  are  in  a  sub-dir. 

chd  i  r  aux 

:  now  proceed  to  the  companion  process. 

if  52 a  !=  q  qoto  xcorop 

:  compile  and  set  up  the  normal  production  version. 

cc  -0  -s  -n  -o  usrtelnetin  us r telnet i n  .c  -lj 

rm  -  f  S1/etc/usrtelnetin 

mv  usrtelnetin  J  1  /  e  t  c 

chmod  555  i1/etc/usrtelnetin 

chown  bin  "?1/etc/usrtelnetin 

chy^rp  bin  $1/etc/usrtelnetin 

goto  compdone 
:  xcomp 

cc  - 0  -s  -n  -o  x usrtelnetin   usrtelnetinl.c  -lj 

rm  -f  $1 /et c / xus r t e  I  net  in 

mv  xusrtelnetin  $  1  /  e  t  c 

chmod  555  $  1  /  e  t  c  / xusrtelnetin 

chown  bin  £1/etc/xusrtelnetin 

chijrp  bin  51/etc/xusrtelnetin 
:  compdone 


help  functions  program 


:  N.B.  this  file  is  a 
cc  -0  -s  -n  help.c  -lj 
rm  -f  $1 /etc /help 
mv  holp  $1 /etc/ help 
chmod  555  $1/etc/help 
chown  I)  in  i1/ctc/help 
chgrp  bin  $1 /etc /help 


link  to  the  ftp  help  program.... 
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:  char  map  creating  program 
cc  -0  -  s  -n    m k  c h  a  r  m  a  p  •  c  -  I  j 
rm  -f  $1 /us  r /b  i  n/rr  k  c  harrr  ap 
m  v  m  k  c  h  a  r  r;.  a  p  31/usr/bin 
chmod  55  5  5- 1 /us  r/b  i  n/mkcharmap 
chown  bin  S 1  / u s r / h i n / in k c h a r n a p 
chgrp  bin  i1 /us  r /bin/r;  k  char  map 


:  ok/  done  there/  now  have  documentation  to  distribute. 

chdir../cioc 

:  the  he lp  text 

cp  usrtelnethelp  $1/mnt/help/telnet 

actually/  ehis  could  be  an  nroff  command  of  the  helpgen  file  plu; 
the  style  macro  package/  but  that  would  be  several  more  absolut- 
pathnames/  which  isnt  a  qood  idea  to  do.   see  the  doc  directory 
uncer  network  documentation. 

chmod  AAA  S1 /rant / he  I p  / 1 e  Ine t 

chown  bin  1 1  /  m  n  t  /  h  e  I  p  / 1  e  I  r.  e  t 

chgrp  bin  $1 /rant / he  I p/t e Ine t 


:  and  the  man  page 

:  which  really  shouldnt  be  here  at  all/  but  in  the  documentation  d- 

cp  telnet. 1  S1/usr/lpd/manuals/man1 

chmod  AAA  S  1  /  u  s  r  / I  p  d  /  ra  a  n  u  a  I  s  /  in  a  n  1  / 1  e  I  n  e  t .  1 

chown  bin  $1  /us  r/  Ipd/manual  s/manl  /'telnet  .1 

chgrp  bin  S1/usr/lpd/ ma nuals/manl /telnet  .1 

:  and  mkcharset  man  page. 

cp  mkchar:u3p.1  SI /us  r/ Ipd/manual  s /man  1 

chmod  AAA  $  1 / u  s  r / I p  d / m  a  n  u  a l s I m a  n 1 / m k  c  h a  r  re  a p . 1 

chown  bin  $1 /us r/ Ipd/manuals/manl  /mkcharmap .1 

chgrp  biri  $  1  /  u s  r  /  I  p  d  /  m  a  n  u  a.l  s  /  m  a  n  1  /  m  k  c  h  a  r  m  a  p  .  1 

:  not  quite  finished  yet...   need  to  do  the  misc  prorjs. 

chdir  ../../hosts 

:  now  for  the  fasthosts  program 

cc  -Osno  fasthosts  tasthosts3.c  -lj 

:  orthogonal  program/  if  already  there/  leave  it  alone. 

mv  fasthosts  $1 /et  c 

chmod  55  S  51 /et c /f ast host s 

chown  bin  $1/ etc/fast  hosts 

chqrp  bin  S1/etc/fasthosts 

and  the  I  MP/ interface  status  program. 

since  interface  may  change/ 
you  m  ~.  y  not  want  this  version, 
chdir  ../netstat 

:  version  tor  the  ACC  interface. 
cc  -0  -s  -n  netstat. c  -lj 

:  orthogon.il  program/  it  already  there/  leave  it  alone, 
mv  net  st  at  'i-1  /etc 
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chmod  bbb  11/ etc/ netst.it 
chown  bin  t1/etc/nctstat 
chgrp  bin  51/etc/netstat 


fin  illy/  done. 
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4   Appendices 

The  materials  in  these  appendices  'are  largely  replications 
of  other  documents.  The  manual  pages  found  here  are/  for  exam- 
ple/ snaps  riots  of  the  usual  Unix  manual  paies  that  may  be  ac- 
cessed via  the  nan  comrrand  (man  (I)).  These  should  be  up  to 
date/  whicn  is  not  guaranteed  for  the  snapshots  in  the  appendix. 

4.1   Manual  Paces 

Only  those  p^qes  that  would  be  useful  to  the  telnet  user  nre 
include  (J  h^re.  For  other  pages/  use  man  (1)  to  produce  copies.. 

4.1.1  User  Telnet 

The  User  Telnet  manual  pages  arc  reproduced  on  following 
pages  . 

4.1.2  Mk char map 

The  mkcharmap  manual  page  is  reproduced  on  following  pages. 
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T  C  L  N  t  T  ( I  ) 


N  AME 


telnet  -  Converse  with  a  hoc t  via  the  network 


SYNOPSIS 

telnet  LhcstnameJ  [<paramet ers>J 
con  ChostnameJ  C<parameters>] 

DESCRIPTION 

Telnet  allows  a  user  to  communicate  with  a  remote  time  shar- 
ing system  across  the  uetwork  (this  document  reflects  ver- 
sion 3 .  V  (11-36)  of  the  user  telnet  code).  Parameters  to 
telnet  are  optional;  if  none  are  oiven  telnet  will  enter  a 
command  accenting  mode.  If  (resent  they  may  consist  of  a 
host  name  followed  by  switches  of  the  form  *  - k ' .  Note  that 
the  Unix  command  'telnet'  and  the  telnet  command  "telnet' 
(and  its  synonyms)  are  syntactically  identical*  however/-  to 
open  a  connection/  a  host  must  be  specified. 

Most  switches  take  adcitional  argument (s)  which  are  usually 
integer(s).  Telnet  will  interpret  any  integer  as  decimal/ 
unless  the  first  digit  is  a  *0*  -  in  which  case  it  will  be 
interpreted  as  octal.  Switcres  eno  their  arguments  (with  in- 
tegers represented  as  *//')  are: 


-a  # 


desired  message  allocation  size 

-d  fc  #  specifies  a  direct  connect  (as  opposed 
to  normal  ICP)  socket.  a  3  2  bit  quantity  *hi  ch  is 
specified  as  two  16  bit  integers/  high  order  por- 
tion first.  usually/  one  wants  the  s  switch/  not 
this  one. 


-h  tf 


host  number  of  the  oesired  host  (use 
hostname ) 


without   the 


-s  tt 

-t  # 


foreign  socket  to  conr.ect  to  (default  is  1) 
number  of  seconds  before  timeout  (default  120) 


The  following  table  is  intended  to  be  a  fast  reference  guide 
for  telnet  users.  It  lists  alt  keywords  user  telnet  will 
recogni?e/  their  prefixes*  arguments/  and  a  very  brief 
description  of  the  command.  For  in  introduction  to  user 
telnet  and/or  more  detailed  information  on  the  commands/ 
refer  to  the  Telnet  User  Manual  (to  be  found  in  the  documen- 
tation directory)/  or  use  the  help  command  from  telnet. 
Items  enclosed  in  square  brackets  ( " C"/  "3")  are  optional; 
commands  enclosed  in  double  braces  ("{{"/  ">>")  are  riot  yet 
implemented;  telnet  protocol  mnemonics  are  enclosed  in  sin- 
gle quotes  ("■"*  "•");  arguments  are  expressed  by  mnemonics 
enclosed  in  anole  brackets  ("<"/  ">"). 
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TELNET  (I  ) 


PREFIX   KEYWORD 


PARAM(S) 


DESCRIPTION 


Csendl 
C  s  e  n  d 3 
[send! 

Cset3 


Csend3 

«CsetJ 

send 

Cset3 

send 

Cset3 

[set] 

Csend3 


CsendD 

<<:Cset3 

CsetJ 

Cset3 
C  s  e  n  d  j 
CechoD 
Cecho3 


CsendD 
Cset3 


ao 
ayt 

ork 

bye 

c  h  a  r  ip  o  d  e 

close 

com  m  diids 

corinec  t 

del 

disconne 

display 

ec 

echo 

el 

e  I  i  ne 

end 

escape 

exit 

joa 

he  Ip 

host  s 

ip 

key 

I  inemode 

load 

m  s  g  m  o  d  e 

nop 

off 

on 

open 

opt  i  on 

qui  t 

send 

set 

s  e  1 1 1  y 

status 

synch 

telnet 

t  e  n  e  x 

wai  t 


ct 


[<po  ramet  ers >3 

<  c  >  "string" 

<mode> 

C<c>3 

<c> 

C<keyword>3 

<c>  "string" 
C<pat hname>3 


<opt>  <n:ode> 

<cmd>  <nrgs> 
<  c  m  d  >  <  a  r  j  s  > 

[host  name  3 

C<parametcrs>3 

<nsccs> 


*  A  tort  Output'  to  server 
'Are  You  There'  to  server 
••UReaK1  to  server 
Synonym  for  end 
Character-wise  I/O 
Terminate  connection 
List  command  keywords 

See  DESCRIPTION 
DELete  (0177)  to  server 
Synonym  for  close 
.v.ap  a  char  front  net)) 
"Erase  Char'  to  server 
Local  echo  "on"  or  "off" 
'Erase  Line'  to  server 
Change  or  see  end  line  chr.r 
Exit  telnet  (closes  conn.) 
Chan 'j  e  or  see  escape  char 
Synonym  for  end 
*60-Aheod'  to  server 
Help  for  keyword  spec'd 
List  network  hostnames 
"Interrupt  Process '-se 
Map  a  char  frorr  key  boa 
Line-wise  I/O 
Load  pre-made  char  m a p 
Message -wi  se  I/O 

*  N  o  -  0  P  e  r  a  t  j  o  n  '  tc  s  c-  r  v 
Set  loctl  echo  off 

Set  local  echo  on 
Synonym  for  connect 
Negotiate  an  option)} 
Synonym  for  end 
Command  prefix  for  novices 
Command  prefix  for  novices 
Inspect  modes  (for  debut.) 
Get  host  or  IMP  status 
"Synch  sequence'  to  server 
Synonym  tor  connect 
Charmode  with  echo  off 
Suspend  keyboard  input 


rv  er 
rri>> 


c  r 


FILES 


dev/ net /<hos tname>   special  file  for  each  host 


/ 

/dev/ net / a  n  y  h  o  s  t 
/etc/i  ass^d 
/etc/help 
<help>/ telnet. hip 
/etc/us rtelnetin 
/etc/fa  st  hosts 
/us  r/  r  in/netstat 
/bin/ sh 


special  file  for  anonymous  host 

for  home  directory  lookup 

help  lookup  program 

help  text  tile 

companion  process  program 

host  status  i-ronram 

IMP /net- interface  status  program 

shell  (to  execute  unknown  commands) 


TCLNLTU  ) 
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sec  ALSO 

mkcha rmap (I ) /  Telnet  User  Manual. 

DIAGNOSTICS 

finny.       Nothing    too    weird    though. 


BUGS 


Option  negotiation  is  not  done  properly  (telnet  should  issue 
an  option  request  and  wait  for  the  server  to  issue  a 
response  -  no  waiting  is  done).  Mo  reasonable  fix  to  this 
problem  is  possible  without  enhancim  Unix  IPC  facilities. 


Mkcharmap(  I) 


16July/V 


M  k  c  h  a  r  m  a  p  ( I  ) 


N  A  -A  b 


Mkcharmap  -  Create  a  character  map  set  for  user  Telnet. 


SYNOPSIS 

mkcharmap 

DESCRIPTION 

Mkcharmap  produces  something  called  a  'character  map  set 
file"  for  use  by  the  user  telnet  program.  This  facility  al- 
lows <;  user  to  define  a  set  of  keys  which  will  not  be  inter- 
preted literally  by  user  telnet/  but  instead/  will  be  mapped 
into  ?.n  arbitrary  (user-defined)  character  strino.  the 
mkcharmap  program  guides  a  user  thru  the  generation  of  a  map 
set  and  outputs  it/  on  command/  to  a  disk  file  (<home 
di rectory>/ charact er_set )  in  the  proper  format  for  user  tel- 
net . 


The  commands  to  mkcharmap  are: 


bye        Exit  the  mkcharmap  program 

define     Define  a  character   to   any 
characters   and   ask   if  it 
terminal  when  invoked.   The 
menting.    backslash   may 
character. 


string   of   arbitrary 

is  to  be  echoed  to  thc- 

corrmand  is  self   docu- 

be   used   to  escape  any 


end 

help 

load 


pr  i  nt 
save 


Exit  the  mkch?rmap  program 

Type  a  little  help  on  the  terminal. 

Load  a  character  map  set  from  *<home 
di r>/ characterise! ' .  Done  automatically  at  ini- 
tial execution  if  s  'charact.er.set'  file  already 
exists. 

Print  the  current  set  of  character  mappings. 

Save  the  current  character  m^ppinis  in  a  file 
named  " < h o m e  dir>/character  set*. 


SCENARIO 

This  is  an  example  of  the  use  of  the  define  command.  It 
maps  the  control  b  character  into  a  connection  to  bbn/  exe- 
cution of  the  * tenex"  command/  and  goes  thru  the  bbn  login 
sequence.  It  is  important  to  remember  that  each  line  of  the 
define  string  is  terminated  with  a  carriage  return  and  an 
new  line/  so  be  careful  when  defining  characters. 


define 

Character  to  be  mapped:*D 

Enter  St r inn  (end  with  cntrl 

con  bbn<cr><lf> 

"wait  1 0  <  c  r  >< 1 1  > 

"tenex <cr><lf> 


c) 


Mk  c  ha r map ( I ) 
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Mkchormap(I) 


"echo  off<cr><l.l> 

lo  i  hotmqrcri  pass  acct  <cr><lf> 

"echo  on<cr><lf> 

-c 

Oo  you  want  this  string  e  c  h  o  e  d  ( y  or  n):n 


FILCS 


/etc/passwd  for  home  directory  Lookup 

/etc/nkch.jrsetheLp    help  text  file 

/foin/sh  shell  (to  execute  unknown  commands) 

SEF.  ALSO 

tclnet(J)/  Telnet  User's  Manual. 

DIAGNOSTICS 

Self-Cxplanatory 


BUGS 


The  only  character  map  set  file  that  can  be  accessed  direct- 
ly is  <hoine  directory>/character_set. 

Not  all  non-printing  characters  are  escaped  in  the   printing 
of  a  map  set  . 


4.?   On  the  Quest  ion  of  User  Telnet  and  IPC 


The  re  seems  lit 
alio*   Unix   telnet 
so noble  manner.   The 
Unix   process   is   s 
Cannot  occur  i n, m e .6 i  a 
under  this  contractC 
reliably   synchroniz 
when  it  is  possible 
network   connection 
1/0  operations  (read 
telnet/-  maun.i  it  a p 
connection  is  manage 
blocking   problem   p 
process  can  reasoneb 
way  of  requests  to  c 


tie  doubt  thdt  something  needs  to  be  done  to 
to  (at  least)  do  option  negotiation  in  a  rca- 

basic  problem  revolves  about  the  fact  thdt  a 
uspendcd  (blocked)-  when  it  requests  I/O  that 
t  e  I  y  .  As  s  t  a  t  e  cJ  in  several  papers  produced 
273*  some  IPC  mechanism  is  needed  to  either 
e  the  two  telnet  processes/  or  inform  telnet 
to  do  1/0  without  being  blocked.    Since   the 

is  a  full  duplex  affair/  any  one  of  the  four 
/write  term inal/network)  possible  can  block 
pear  hung  for  the  others;  so  e.ich  half  of  the 
d  by  one  process.  Thus  the  so  I  vine;  of  the 
roduces  a  problem  in  altering  mode  -  neither 
I y  find  out  what  the  other  has  seen  in  the 
hange  mode. 


For 
ec  ho . 
a  r  *  p  r  o  p  r  i 
host  '  s 
new  requ 
command  . 
keyboard 
c  a  me   in 
net  (or 
on  that 


e  y.  am 
The  t 
ate  p 
reply 
est  t 
Co 

to  n 

f  ro 

a  oip 

read. 


pie/  the  user  types  a  command  to  switch  to  remote 
erminal  to  network  user  telnet  process  sends  out  the 
rotocol  to  accomplish  the  change.  When  the  foreign 
reaches  the  network  to  terminal  process/  it  sees  a 
o  change  state-/  as  it  didn't  know  about  the  user's 
nversely/  if  the  remote  host  desires  a  channe/  the 
etwork  process  will  never  find  out  that  protocol 
m  the  net  requesting  the  change  without  reading  the 
e  back  from  the  companion)  and/  just  maybe/  blocking 


Assuming  the  existence  of  a  reasonably  flexible  IPC 
ty/  several  of  the  sore  spots  in  telnet  can  be  repaired.  Some 
reriesijn  is  required  to  adapt  to  the  new  facilities/  ;>ut  most  of 
that  work  is  focused  on  the  interfacing  and  majjr  flow  of  con- 
trol. Much  of  the  code  in  both  the  user  and  server  telnet  pro- 
grams will  survive  the  change-over.  However/  that  topic  is  just 
outside  the  scope  of  this  manual;  refer  to  the  Telnet  Functional 
Description  also  produced  under  this  contract. 


[271  i^efer  to  the  Request  for  Comments  on  Unix 
InterProcess  Communication/  the  Telnet  Functional 
Description/  and  Telnet  Program  Specification  produced  under 
this  contract  for  discussion  of  the  problems  and  solutions 
presented. 


